D3DXCreateVolumeTexture 函式
建立空的磁片區紋理，視需要調整呼叫參數。
語法
HRESULT D3DXCreateVolumeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT Depth,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
參數
-
pDevice [in]
-
IDirect3DDevice9介面的指標，代表要與磁片區紋理相關聯的裝置。
-
寬度 [in]
-
類型： UINT
以圖元為單位的寬度。 這個值必須是非零值。 驅動程式支援 (寬度、高度和深度) 的最大維度可以在 D3DCAPS9的 MaxVolumeExtent 中找到。
-
高度 [in]
-
類型： UINT
高度以圖元為單位。 這個值必須是非零值。 驅動程式支援 (寬度、高度和深度) 的最大維度可以在 D3DCAPS9的 MaxVolumeExtent 中找到。
-
深度 [in]
-
類型： UINT
以圖元為單位的深度。 這個值必須是非零值。 驅動程式支援 (寬度、高度和深度) 的最大維度可以在 D3DCAPS9的 MaxVolumeExtent 中找到。
-
MipLevels [in]
-
類型： UINT
要求的 mip 層級數目。 如果此值為零或D3DX_DEFAULT，則會建立完整的 mipmap 鏈結。
-
使用量 [in]
-
類型： DWORD
0 或 D3DUSAGE_DYNAMIC。 如需使用動態紋理的詳細資訊，請參閱 使用動態紋理。
-
格式 [in]
-
類型： D3DFORMAT
D3DFORMAT列舉類型的成員，描述磁片區紋理的要求像素格式。 傳回的磁片區紋理可能與 Format 所指定的格式不同。 應用程式應該檢查所傳回磁片區紋理的格式。
-
集 區 [in]
-
類型： D3DPOOL
D3DPOOL列舉型別的成員，描述應該放置磁片區紋理的記憶體類別。
-
ppVolumeTexture [out]
-
IDirect3DVolumeTexture9介面指標的位址，代表已建立的磁片區紋理物件。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL E_OUTOFMEMORY 。
備註
在內部，D3DXCreateVolumeTexture 會使用 D3DXCheckVolumeTextureRequirements 來調整呼叫參數。 因此，對 D3DXCreateVolumeTexture 的呼叫通常會成功，而 CreateVolumeTexture 的呼叫將會失敗。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱