共用方式為


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]

類型: LPDIRECT3DDEVICE9

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]

類型: LPDIRECT3DVOLUMETEXTURE9*

IDirect3DVolumeTexture9介面指標的位址,代表已建立的磁片區紋理物件。

傳回值

類型: HRESULT

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

備註

在內部,D3DXCreateVolumeTexture 會使用 D3DXCheckVolumeTextureRequirements 來調整呼叫參數。 因此,對 D3DXCreateVolumeTexture 的呼叫通常會成功,而 CreateVolumeTexture 的呼叫將會失敗。

規格需求

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

另請參閱

D3DX 9 中的紋理函式