共用方式為


IDirect3DDevice9Ex::CreateRenderTargetEx 方法 (d3d9.h)

建立轉譯目標介面。

語法

HRESULT CreateRenderTargetEx(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle,
  [in]          DWORD               Usage
);

參數

[in] Width

類型: UINT

轉譯目標表面的寬度,以像素為單位。

[in] Height

類型: UINT

轉譯目標表面的高度,以像素為單位。

[in] Format

類型: D3DFORMAT

D3DFORMAT列舉型別的成員,描述轉譯目標的格式。

[in] MultiSample

類型: D3DMULTISAMPLE_TYPE

D3DMULTISAMPLE_TYPE列舉型別的成員,其描述多重取樣緩衝區類型。 此參數會指定這個轉譯目標的反鋸齒類型。 當此表面傳遞至 IDirect3DDevice9::SetRenderTarget 時,其多重取樣類型必須與 IDirect3DDevice9::SetDepthStencilSurface 所設定的深度樣板類型相同。

[in] MultisampleQuality

類型: DWORD

質量等級。 有效範圍介於零到一個小於 IDirect3D9::CheckDeviceMultiSampleType 所傳回的 pQualityLevels 所傳回的層級之間。 傳遞較大的值會傳回錯誤,D3DERR_INVALIDCALL。 配對轉譯目標的 MultisampleQuality 值、深度樣板表面和多重取樣類型必須全部相符。

[in] Lockable

類型: BOOL

除非應用程式針對 Lockable 指定 TRUE ,否則轉譯目標不可鎖定。

請注意,可鎖定的轉譯目標可降低某些圖形硬體的效能。 讀取效能 (將數據從視訊記憶體移至系統記憶體) 取決於 AGP 與 PCI Express) (所使用的硬體類型,而且通常比將數據從系統移至視訊記憶體) 上傳效能遠低於上傳效能 (。 如果您需要轉譯目標的讀取許可權,請使用 GetRenderTargetData ,而不是可鎖定的轉譯目標。

[out, retval] ppSurface

類型: IDirect3DSurface9**

IDirect3DSurface9 介面指標的位址。

[in] pSharedHandle

類型: HANDLE*

保留的。 將此參數設定為 NULL。 此參數可用於 Direct3D 9,讓 Windows Vista 共用資源

[in] Usage

類型: DWORD

一或多個 D3DUSAGE 常數的組合,這些常數可以一起進行 OR。 值為 0 表示沒有使用方式。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,傳回值可以是下列其中一項:D3DERR_NOTAVAILABLE、D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY。

備註

轉譯目標介面會放在D3DPOOL_DEFAULT記憶體類別中。

不支援建立可鎖定的多取樣轉譯目標。

規格需求

需求
目標平台 Windows
標頭 d3d9.h
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9Ex