D3DXSaveSurfaceToFile fonction)

Enregistre une surface dans un fichier.

Syntaxe

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

Paramètres

pDestFile [ dans]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de fichier de l’image de destination. Si les paramètres du compilateur requièrent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Dans le cas contraire, le type de données String est résolu en LPCSTR. Consultez la section Notes.

DestFormat [ dans]

Type : D3DXIMAGE _ FILEFORMAT

D3DXIMAGE _ FILEFORMAT spécifiant le format de fichier à utiliser lors de l’enregistrement. Cette fonction prend en charge l’enregistrement dans tous les formats D3DXIMAGE _ FILEFORMAT , sauf portable pixmap (. ppm) et Targa/Truevision Graphics Adapter (. TGA).

pSrcSurface [ dans]

Type : LPDIRECT3DSURFACE9

Pointeur vers l’interface IDirect3DSurface9 , contenant l’image à enregistrer.

pSrcPalette [ dans]

Type : const PaletteEntry *

Pointeur vers une structure PaletteEntry contenant une palette de 256 couleurs. Ce paramètre peut être NULL.

pSrcRect [ dans]

Type : const Rect *

Pointeur vers une structure Rect . Spécifie le rectangle source. Affectez la valeur null à ce paramètre pour spécifier la totalité de l’image.

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être la suivante : D3DERR _ INVALIDCALL

Remarques

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXSaveSurfaceToFileW. Dans le cas contraire, l’appel de fonction est résolu en D3DXSaveSurfaceToFileA, car les chaînes ANSI sont utilisées.

Cette fonction gère la conversion vers et à partir des formats de texture compressés.

Configuration requise

Condition requise Valeur
En-tête
D3dx9tex. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions de texture dans D3DX 9

D3DXSaveTextureToFile

D3DXSaveVolumeToFile