Поделиться через

Метод IDirectDrawSurface7::GetAttachedSurface (ddraw.h)

  • Статья

Получает присоединенную поверхность, которая имеет указанные возможности, и увеличивает количество ссылок извлеченного интерфейса.

Синтаксис

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

Параметры

[in] unnamedParam1

Указатель на структуру DDSCAPS2 , которая указывает аппаратные возможности присоединенной поверхности.

[out] unnamedParam2

Указатель на переменную для получения указателя на интерфейс IDirectDrawSurface7 извлеченной поверхности. Полученная поверхность соответствует описанию в соответствии с параметром lpDDSCaps .

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет DD_OK.

В случае сбоя метод может вернуть одно из следующих значений ошибки:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOTFOUND
  • DDERR_SURFACELOST

Комментарии

Вложения используются для подключения нескольких объектов DirectDrawSurface к сложным структурам, таким как сложные структуры, необходимые для поддержки трехмерного переворачивания страниц с помощью z-буферов. GetAttachedSurface завершается сбоем , если подключено несколько поверхностей, соответствующих запрошенным возможностям. В этом случае приложение должно использовать метод IDirectDrawSurface7::EnumAttachedSurfaces для получения присоединенных поверхностей.

Требования

Требование Значение
Целевая платформа Windows
Header ddraw.h
Библиотека Ddraw.lib
DLL Ddraw.dll

См. также раздел

IDirectDrawSurface7