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 |
|
| Bibliothèque |
|