D3DXCheckTextureRequirements 函式
檢查紋理建立參數。
語法
HRESULT D3DXCheckTextureRequirements(
_In_ LPDIRECT3DDEVICE9 pDevice,
_Inout_ UINT *pWidth,
_Inout_ UINT *pHeight,
_Inout_ UINT *pNumMipLevels,
_In_ DWORD Usage,
_Inout_ D3DFORMAT *pFormat,
_In_ D3DPOOL Pool
);
參數
-
pDevice [in]
-
IDirect3DDevice9介面的指標，代表要與紋理相關聯的裝置。
-
pWidth [in， out]
-
類型： UINT*
以圖元為單位的要求寬度指標，或 Null。 傳回更正的大小。
-
pHeight [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_INVALIDCALL，D3DERR_NOTAVAILABLE。
備註
如果此函式的參數無效，此函式會傳回更正的參數。
當比較要求的需求與可用格式時，此函式會使用下列啟發學習法：
- 請勿選擇具有較少通道的格式。
- 除非明確要求，否則請避免 FOURCC 和 24 位格式。
- 請嘗試不要新增通道。
- 請嘗試不要變更每個通道的位數。
- 請嘗試避免在格式類型之間轉換。 例如，請避免將 ARGB 格式轉換成深度格式。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱