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 常數的組合,這些常數可以合併在一起。 值為 0 表示沒有使用方式。
傳回值
類型: HRESULT
如果方法成功,傳回值會D3D_OK。 如果方法失敗,則傳回值可以是下列專案:D3DERR_INVALIDCALL。
備註
D3DPOOL_SCRATCH會傳回與 DirectX 8.x 方法 CreateImageSurface 所建立表面具有相同特性的介面。
D3DPOOL_DEFAULT是與 IDirect3DDevice9::StretchRect 和 IDirect3DDevice9::ColorFill搭配使用的適當集區。
在建立外螢幕純螢幕時,不允許D3DPOOL_MANAGED。 如需記憶體集區的詳細資訊,請參閱 D3DPOOL。
不論其集區類型為何,螢幕外純螢幕都一律可鎖定。
需求
目標平台 | Windows |
標頭 | d3d9.h |
程式庫 | D3D9.lib |