ID3DXFile::CreateSaveObject, méthode

Article
06/13/2023

Crée un objet d’enregistrement qui sera utilisé pour enregistrer des données dans un fichier .x.

Syntaxe

HRESULT CreateSaveObject(
  [in]  LPCVOID               pData,
  [in]  D3DXF_FILESAVEOPTIONS flags,
  [in]  D3DXF_FILEFORMAT      dwFileFormat,
  [out] ID3DXFileSaveObject   **ppSaveObj
);

Paramètres

pData [in]

Type : LPCVOID

Pointeur vers le nom du fichier à utiliser pour enregistrer des données.

indicateurs [in]

Type : D3DXF_FILESAVEOPTIONS

Valeur qui spécifie le nom du fichier dans lequel les données doivent être enregistrées. Cette valeur peut être l’un des indicateurs Options d’enregistrement de fichier .

dwFileFormat [in]

Type : D3DXF_FILEFORMAT

Indique le format à utiliser lors de l’enregistrement du fichier .x. Cette valeur peut être l’un des indicateurs Formats de fichier . Pour plus d'informations, consultez la section Notes.

ppSaveObj [out]

Type : ID3DXFileSaveObject**

Adresse d’un pointeur vers une interface ID3DXFileSaveObject , représentant l’objet save créé.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est S_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : D3DXFERR_BADVALUE, D3DXFERR_PARSEERROR.

Notes

Après avoir utilisé cette méthode, utilisez les méthodes de l’interface ID3DXFileSaveObject pour créer des objets de données et enregistrer des modèles ou des données.

Pour le format de fichier enregistré dwFileFormat, l’un des indicateurs binaires, binaires hérités ou texte dans Formats de fichier doit être spécifié. Le fichier peut être compressé à l’aide de l’indicateur de D3DXF_FILEFORMAT_COMPRESSED facultatif.

Les valeurs de format de fichier peuvent être combinées dans un OR logique pour créer du texte compressé ou des fichiers binaires compressés. Si vous indiquez que le format de fichier doit être texte et compressé, le fichier est d’abord écrit en tant que texte, puis compressé. Toutefois, les fichiers texte compressés ne sont pas aussi efficaces que les fichiers texte binaires ; dans la plupart des cas, vous devez donc indiquer binaire et compressé.

Spécifications

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

Voir aussi

ID3DXFile
ID3DXFileSaveObject

Partager via