D3DXLoadVolumeFromResource 函式
從資源載入磁片區。
語法
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
參數
-
pDestVolume [in]
-
IDirect3DVolume9 介面的指標。 指定目的地磁片區。
-
pDestPalette [in]
-
類型：const PALETTEENTRY*
PALETTEENTRY結構的指標、256 種色彩或Null的目的地調色盤。
-
pDestBox [in]
-
類型：const D3DBOX*
D3DBOX結構的指標。 指定目的地方塊。 將此參數設定為 Null ，以指定整個磁片區。
-
hSrcModule [in]
-
類型： HMODULE
處理資源所在的模組，或針對與作業系統用來建立目前進程之映射相關聯的模組 Null 。
-
pSrcResource [in]
-
類型： LPCSTR
指定來源映射檔案名的字串指標。 如果已定義 UNICODE 或_UNICODE，則此參數類型為 LPCWSTR，否則類型為 LPCSTR。
-
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。
備註
正在載入的資源必須是點陣圖資源 (RT_BITMAP) 。
此函式會處理與壓縮紋理格式之間的轉換。
寫入磁片區紋理的非層級零表面，將不會更新已變更的矩形。 如果 呼叫 D3DXLoadVolumeFromFile 且紋理尚未變更， (這不太可能在一般使用案例中) ，應用程式必須在磁片區紋理上明確呼叫 IDirect3DVolumeTexture9：：AddDirtyBox 。
此函式同時支援 Unicode 和 ANSI 字串。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱