HRESULT GetAttachedSurface (LPDDSCAPS lpDDSCaps,
LPLPDIRECTDRAWSURFACE FAR * lplpDDAttachedSurface);
Получает присоединенную поверхность, которая имеет определенные возможности.
Возвращает DD_OK если успешно, или одно из следующих значений ошибки:
DDERR_INVALIDOBJECT DDERR_INVALIDPARAMS
DDERR_NOTFOUND DDERR_SURFACELOST
lpDDSCaps
Адрес структуры DDSCAPS, которая содержит аппаратные возможности поверхности.
lplpDDAttachedSurface
Адрес указателя на DirectDrawSurface, который будет присоединен к текущему DirectDrawSurface, определенному lpDDSurface и имеет возможности, которые соответствуют определенному параметру lpDDSCaps.
Присоединения используются, чтобы соединить многочисленные объекты DirectDrawSurface в сложные структуры, подобно 3D странице, переключающейся с z-буферами. Вызов метода будет неудачен, если присоединена больше чем одна поверхность, для запрошенных возможностей. В этом случае, прикладная программа должна использовать IDirectDrawSurface:: EnumAttachedSurfaces, чтобы получить неуникальные присоединенные поверхности.