Метод IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx (d3d9.h)
Создание поверхности за кадром.
Синтаксис
HRESULT CreateOffscreenPlainSurfaceEx(
[in] UINT Width,
[in] UINT Height,
[in] D3DFORMAT Format,
[in] D3DPOOL Pool,
[out, retval] IDirect3DSurface9 **ppSurface,
[in] HANDLE *pSharedHandle,
[in] DWORD Usage
);
Параметры
[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 для совместного использования ресурсов.
[in] Usage
Тип: DWORD
Сочетание одной или нескольких констант D3DUSAGE , которые могут быть or'd вместе. Значение 0 указывает на отсутствие использования.
Возвращаемое значение
Тип: 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.lib |