Fonction D3DXSaveVolumeToFile
Enregistre un volume dans un fichier sur disque.
Syntaxe
HRESULT D3DXSaveVolumeToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DVOLUME9 pSrcVolume,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox
);
Paramètres
-
pDestFile [in]
-
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 nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.
-
DestFormat [in]
-
Type : D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT spécifier le format de fichier à utiliser lors de l’enregistrement. Cette fonction prend en charge l’enregistrement dans tous les formats D3DXIMAGE_FILEFORMAT , à l’exception de Portable Pixmap (.ppm) et de L’adaptateur graphique Targa/Truevision (.tga).
-
pSrcVolume [in]
-
Type : LPDIRECT3DVOLUME9
Pointeur vers l’interface IDirect3DVolume9 contenant l’image à enregistrer.
-
pSrcPalette [in]
-
Type : const PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY contenant une palette de 256 couleurs. Ce paramètre peut être NULL.
-
pSrcBox [in]
-
Type : const D3DBOX*
Pointeur vers une structure D3DBOX . Spécifie la zone source. Définissez ce paramètre sur NULL pour spécifier le volume entier.
Valeur retournée
Type : HRESULT
Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être la suivante : D3DERR_INVALIDCALL
Notes
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 D3DXSaveVolumeToFileW. Sinon, l’appel de fonction est résolu en >D3DXSaveVolumeToFileA, car les chaînes ANSI sont utilisées.
Cette fonction gère la conversion vers et à partir des formats de texture compressés.
Si le volume n’est pas dynamique (en raison d’un paramètre d’utilisation défini sur 0 lors de la création) et se trouve dans la mémoire vidéo (le pool de mémoire défini sur D3DPOOL_DEFAULT), D3DXSaveTextureToFile échoue, car D3DX ne peut pas verrouiller les volumes non dynamiques situés dans la mémoire vidéo.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi