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 指定儲存時要使用的檔案格式。 此函式支援儲存到所有 D3DXIMAGE_FILEFORMAT 格式，但可攜式 Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 除外。

pSrcVolume [in]

類型： LPDIRECT3DVOLUME9

包含要儲存之影像的 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 無法鎖定位於視訊記憶體中的非動態磁碟區。

規格需求

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

另請參閱

D3DX 9 中的紋理函式

D3DXSaveSurfaceToFile

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory