D3DXSaveSurfaceToFile 関数

D3DXSaveSurfaceToFile 関数

サーフェイスをファイルに保存する。

構文

HRESULT D3DXSaveSurfaceToFile(      
    LPCTSTR pDestFile,
    D3DXIMAGE_FILEFORMAT DestFormat,
    LPDIRECT3DSURFACE9 pSrcSurface,
    const PALETTEENTRY *pSrcPalette,
    const RECT *pSrcRect
);

パラメータ

• pDestFile
  [in] ソース イメージのファイル名を指定する文字列へのポインタ。コンパイラの設定が Unicode を要求している場合、データ タイプ LPCTSTR は LPCWSTR になる。それ以外の場合は、この文字列のデータ タイプは LPCSTR になる。「注意」を参照すること。
• DestFormat
  [in] 保存するときに使うファイル フォーマットを指定する D3DXIMAGE_FILEFORMAT。
• pSrcSurface
  [in] 保存するイメージを含む IDirect3DSurface9 インターフェイスへのポインタ。
• pSrcPalette
  [in] 256 色のパレットを含む PALETTEENTRY 構造体へのポインタ。このパラメータは NULL にしてもよい。
• pSrcRect
  [in] RECT 構造体へのポインタ。転送元矩形を指定する。このパラメータに NULL を設定して、イメージ全体を指定する。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、次の値を返す。

注意

コンパイラの設定によって関数のバージョンも決まる。Unicode が定義されている場合、この関数の呼び出しは D3DXSaveSurfaceToFileW になる。それ以外の場合は ANSI 文字列を使用するので、この関数の呼び出しは D3DXSaveSurfaceToFileA になる。

この関数がサポートしている ファイル フォーマットは、.bmp および .dds である。

この関数は、圧縮テクスチャ フォーマット間の変換を処理する。

関数の情報

参照

D3DXSaveTextureToFile、D3DXSaveVolumeToFile