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是與 IDirect3DDevice9：：StretchRect 和 IDirect3DDevice9：：ColorFill搭配使用的適當集區。

在建立外螢幕純螢幕時，不允許D3DPOOL_MANAGED。 如需記憶體集區的詳細資訊，請參閱 D3DPOOL。

不論其集區類型為何，螢幕外純螢幕都一律可鎖定。

需求

   
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9