D3DXCreateRenderToSurface 函式

建立轉譯表面。

語法

HRESULT D3DXCreateRenderToSurface(
  _In_  LPDIRECT3DDEVICE9     pDevice,
  _In_  UINT                  Width,
  _In_  UINT                  Height,
  _In_  D3DFORMAT             Format,
  _In_  BOOL                  DepthStencil,
  _In_  D3DFORMAT             DepthStencilFormat,
  _Out_ LPD3DXRENDERTOSURFACE *ppRenderToSurface
);

參數

pDevice [in]

類型： LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標，裝置要與轉譯表面相關聯。

寬度 [in]

類型： UINT

轉譯表面的寬度，以圖元為單位。

高度 [in]

類型： UINT

轉譯表面的高度，以圖元為單位。

格式 [in]

類型： D3DFORMAT

D3DFORMAT列舉類型的成員，描述轉譯介面的像素格式。

DepthStencil [in]

類型： BOOL

如果 為 TRUE，則轉譯表面支援深度樣板表面。 否則，這個成員會設定為 FALSE。 此函式會建立新的深度緩衝區。

DepthStencilFormat [in]

類型： D3DFORMAT

如果 DepthStencil 設定為 TRUE，則此參數是 D3DFORMAT 列舉類型的成員，描述轉譯介面的深度樣板格式。

ppRenderToSurface [out]

類型： LPD3DXRENDERTOSURFACE*

ID3DXRenderToSurface介面指標的位址，代表所建立的轉譯介面。

傳回值

類型： HRESULT

如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL，E_OUTOFMEMORY。

規格需求

另請參閱

常規用途函式