D3DXLoadVolumeFromFileInMemory 函式

從記憶體中的檔案載入磁片區。

語法

HRESULT D3DXLoadVolumeFromFileInMemory(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       LPCVOID           pSrcData,
  _In_       UINT              SrcDataSize,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

參數

pDestVolume [in]

類型： LPDIRECT3DVOLUME9

IDirect3DVolume9 介面的指標。 指定目的地磁片區。

pDestPalette [in]

類型：const PALETTEENTRY*

PALETTEENTRY結構的指標、256 種色彩或Null的目的地調色盤。

pDestBox [in]

類型：const D3DBOX*

D3DBOX結構的指標。 指定目的地方塊。 將此參數設定為 Null ，以指定整個磁片區。

pSrcData [in]

類型： LPCVOID

記憶體中要從中載入磁片區的檔案指標。

SrcDataSize [in]

類型： UINT

以位元組為單位的記憶體檔案大小。

pSrcBox [in]

類型：const D3DBOX*

D3DBOX結構的指標。 指定來源方塊。 將此參數設定為 Null ，以指定整個磁片區。

篩選 [in]

類型： DWORD

一或多個 D3DX_FILTER的組合，控制影像的篩選方式。 指定此參數的D3DX_DEFAULT相當於指定D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。

ColorKey [in]

類型： D3DCOLOR

要以透明黑色取代的D3DCOLOR值，或 0 以停用色彩索引鍵。 這一律是 32 位的 ARGB 色彩，與來源影像格式無關。 Alpha 相當重要，而且通常應該設定為 FF 以取得不透明色彩索引鍵。 因此，對於不透明黑色，此值會等於0xFF000000。

pSrcInfo [in]

類型： D3DXIMAGE_INFO*

要填入來源影像檔或Null中資料描述之D3DXIMAGE_INFO結構的指標。

傳回值

類型： HRESULT

如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL，D3DXERR_INVALIDDATA。

備註

此函式處理壓縮紋理格式的轉換，並支援下列檔案格式：.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 請參閱 D3DXIMAGE_FILEFORMAT。

寫入磁片區紋理的非層級零表面，將不會更新已變更的矩形。 如果 呼叫 D3DXLoadVolumeFromFileInMemory ，而且紋理尚未變更 (在一般使用案例中不太可能) ，應用程式必須在磁片區紋理上明確呼叫 IDirect3DVolumeTexture9：：AddDirtyBox 。

規格需求

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

另請參閱

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromResource

D3DXLoadVolumeFromVolume

D3DX 9 中的紋理函式