共用方式為


D3DXCreateVolumeTextureFromResource 函式

從資源建立磁片區紋理。

語法

HRESULT D3DXCreateVolumeTextureFromResource(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  HMODULE                  hSrcModule,
  _In_  LPCTSTR                  pSrcResource,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

參數

pDevice [in]

類型: LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標,代表要與磁片區紋理相關聯的裝置。

hSrcModule [in]

類型: HMODULE

處理資源所在的模組,或與作業系統用來建立目前進程之映射相關聯的模組 Null

pSrcResource [in]

類型: LPCTSTR

指定資源名稱的字串指標。 如果編譯器設定需要 Unicode,LPCTSTR 資料類型會解析為 LPCWSTR。 否則,字串資料類型會解析為 LPCSTR。 請參閱<備註>。

ppVolumeTexture [out]

類型: LPDIRECT3DVOLUMETEXTURE9*

代表所建立紋理物件的 IDirect3DVolumeTexture9 介面指標位址。

傳回值

類型: HRESULT

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

備註

編譯器設定也會決定函式版本。 如果定義 Unicode,函式呼叫會解析為 D3DXCreateVolumeTextureFromResourceW。 否則,函式呼叫會解析為 D3DXCreateVolumeTextureFromResourceA,因為正在使用 ANSI 字串。

函式相當於 D3DXCreateVolumeTextureFromResourceEx (pDevice、hSrcModule、pSrcResource、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 NullNull、ppVolumeTexture) 。

正在載入的資源必須是應用程式定義的資源 (RT_RCDATA) 。

此函式支援下列檔案格式:.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 請參閱 D3DXIMAGE_FILEFORMAT

請注意,從 IDirect3DDevice9 物件呼叫時,使用此函式所建立的資源將會放在D3DPOOL_MANAGED所表示的記憶體類別中。 從 IDirect3DDevice9Ex 物件呼叫這個方法時,資源會放在以 D3DPOOL_DEFAULT表示的記憶體類別中。

篩選會自動套用至使用此方法建立的紋理。 篩選相當於D3DX_FILTER_TRIANGLE |D3DX_FILTER中的 D3DX_FILTER_DITHER

規格需求

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

另請參閱

D3DXCreateVolumeTextureFromFile

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResourceEx

D3DX 9 中的紋理函式