D3DXSaveSurfaceToFile 函式
將表面儲存至檔案。
語法
HRESULT D3DXSaveSurfaceToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect
);
參數
-
pDestFile [in]
-
類型： LPCTSTR
指定目的地影像檔案名的字串指標。 如果編譯器設定需要 Unicode，LPCTSTR 資料類型會解析為 LPCWSTR。 否則，字串資料類型會解析為 LPCSTR。 請參閱＜備註＞。
-
DestFormat [in]
-
D3DXIMAGE_FILEFORMAT 指定儲存時要使用的檔案格式。 此函式支援儲存到所有 D3DXIMAGE_FILEFORMAT 格式，但可攜式 Pixmap (.ppm) 和 Targa/Truevision Graphics Adapter (.tga) 除外。
-
pSrcSurface [in]
-
IDirect3DSurface9介面的指標，其中包含要儲存的影像。
-
pSrcPalette [in]
-
類型：const PALETTEENTRY*
PALETTEENTRY結構的指標，其中包含 256 種色彩的調色盤。 此參數可以是 Null。
-
pSrcRect [in]
-
類型：const RECT*
RECT結構的指標。 指定來源矩形。 將此參數設定為 Null ，以指定整個映射。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列專案：D3DERR_INVALIDCALL
備註
編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 D3DXSaveSurfaceToFileW。 否則，函式呼叫會解析為 D3DXSaveSurfaceToFileA，因為正在使用 ANSI 字串。
此函式會處理與壓縮紋理格式之間的轉換。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱