Метод IDirect3DDevice9::CreateOffscreenPlainSurface (d3d9helper.h)

  • Статья

Создайте поверхность за кадром.

Синтаксис

HRESULT CreateOffscreenPlainSurface(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DSurface9 **ppSurface,
  [in]          HANDLE            *pSharedHandle
);

Параметры

[in] Width

Тип: UINT

Ширина поверхности.

[in] Height

Тип: UINT

Высота поверхности.

[in] Format

Тип: D3DFORMAT

Формат поверхности. См . раздел D3DFORMAT.

[in] Pool

Тип: D3DPOOL

Тип пула Surface. См . раздел D3DPOOL.

[out, retval] ppSurface

Тип: IDirect3DSurface9**

Указатель на созданный интерфейс IDirect3DSurface9 .

[in] pSharedHandle

Тип: HANDLE*

Зарезервировано. Задайте для этого параметра значение NULL. Этот параметр можно использовать в Direct3D 9 для Windows Vista для совместного использования ресурсов.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается ошибкой, возвращаемое значение может быть следующим: D3DERR_INVALIDCALL.

Комментарии

D3DPOOL_SCRATCH вернет поверхность с характеристиками, идентичными поверхности, созданной методом DirectX 8.x CreateImageSurface.

D3DPOOL_DEFAULT является подходящим пулом для использования с IDirect3Device9::StretchRect и IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED не допускается при создании открытой поверхности вне экрана. Дополнительные сведения о пулах памяти см. в разделе D3DPOOL.

Обычные поверхности вне экрана всегда блокируются, независимо от типов пулов.

Требования

   
Целевая платформа Windows
Header d3d9helper.h (включая D3D9.h)
Библиотека D3D9.lib

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

IDirect3DDevice9