Метод IDirect3DDevice9::CreateOffscreenPlainSurface (d3d9.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 | d3d9.h (включая D3D9.h) |
| Библиотека | D3D9.lib |