D3DXSaveVolumeToFile 函式
將磁片區儲存到磁片上的檔案。
語法
HRESULT D3DXSaveVolumeToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox
);
參數
-
pDestFile [in]
-
類型： LPCTSTR
指定目的地影像檔案名的字串指標。 如果編譯器設定需要 Unicode，LPCTSTR 資料類型會解析為 LPCWSTR。 否則，字串資料類型會解析為 LPCSTR。 請參閱＜備註＞。
-
DestFormat [in]
-
D3DXIMAGE_FILEFORMAT 指定儲存時要使用的檔案格式。 此函式支援儲存到所有 D3DXIMAGE_FILEFORMAT 格式，但可攜式 Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 除外。
-
pSrcVolume [in]
-
包含要儲存之影像的 IDirect3DVolume9 介面指標。
-
pSrcPalette [in]
-
類型：const PALETTEENTRY*
PALETTEENTRY結構的指標，其中包含 256 種色彩的調色盤。 此參數可以是 Null。
-
pSrcBox [in]
-
類型：const D3DBOX*
D3DBOX結構的指標。 指定來源方塊。 將此參數設定為 Null ，以指定整個磁片區。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列專案：D3DERR_INVALIDCALL
備註
編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 D3DXSaveVolumeToFileW。 否則，函式呼叫會解析為 > D3DXSaveVolumeToFileA，因為正在使用 ANSI 字串。
此函式會處理與壓縮紋理格式之間的轉換。
如果磁片區是非動態 (，因為建立) 時使用參數設定為 0，而且位於視訊記憶體 (記憶體集區設定為 D3DPOOL_DEFAULT) ， D3DXSaveTextureToFile 將會失敗，因為 D3DX 無法鎖定位於視訊記憶體中的非動態磁碟區。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱