D3DXCheckCubeTextureRequirements 函式

檢查 Cube-texture-creation 參數。

語法

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

參數

pDevice [in]

類型： LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標，代表要與 Cube 紋理相關聯的裝置。

pSize [in， out]

類型： UINT*

要求寬度和高度的指標，以圖元為單位，或 Null。 傳回更正的大小。

pNumMipLevels [in， out]

類型： UINT*

要求的 Mipmap 層級數目或 Null的指標。 傳回修正的 mipmap 層級數目。

使用量 [in]

類型： DWORD

0 或 D3DUSAGE_RENDERTARGET。 將此旗標設定為 D3DUSAGE_RENDERTARGET 表示表面要當做轉譯目標使用。 然後，資源可以傳遞至 SetRenderTarget 方法的 pNewRenderTarget 參數。 如果指定D3DUSAGE_RENDERTARGET，應用程式應該呼叫 CheckDeviceFormat來檢查裝置是否支援此作業。

pFormat [in， out]

類型： D3DFORMAT*

D3DFORMAT列舉型別成員的指標。 指定所需的像素格式或 Null。 傳回更正的格式。

集區 [in]

類型： D3DPOOL

D3DPOOL列舉型別的成員，描述應該放置紋理的記憶體類別。

傳回值

類型： HRESULT

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

備註

如果此函式的參數無效，此函式會傳回更正的參數。

Cube 紋理與其他表面不同，因為它們是表面集合。 若要使用 Cube 紋理呼叫 SetRenderTarget ，您必須使用 GetCubeMapSurface 選取個別臉部，並將產生的表面傳遞至 SetRenderTarget。

規格需求

需求	值
標頭	D3dx9tex.h
程式庫	D3dx9.lib

另請參閱

D3DX 9 中的紋理函式