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]
-
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。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱