Méthode IDirectXFile::CreateSaveObject
Crée un objet d’enregistrement. Action déconseillée.
Syntaxe
HRESULT CreateSaveObject(
[in] LPCSTR szFileName,
[in] DXFILEFORMAT dwFileFormat,
[out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);
Paramètres
-
szFileName [in]
-
Type : LPCSTR
Pointeur vers le nom du fichier à utiliser pour enregistrer des données.
-
dwFileFormat [in]
-
Type : DXFILEFORMAT
Indique le format à utiliser lors de l’enregistrement du fichier DirectX. Cette valeur peut être l’un des indicateurs DXFILEFORMAT_xxx dans les constantes DXFILE. Pour plus d'informations, consultez la section Notes.
-
ppSaveObj [out, retval]
-
Type : LPDIRECTXFILESAVEOBJECT*
Adresse d’un pointeur vers une interface IDirectXFileSaveObject , représentant l’objet d’enregistrement créé.
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est DXFILE_OK. Si la méthode échoue, la valeur de retour peut être l’une des suivantes : DXFILEERR_BADALLOC, DXFILEERR_BADFILE, DXFILEERR_BADVALUE.
Notes
Après avoir utilisé cette méthode, utilisez les méthodes de l’interface IDirectXFileSaveObject pour créer des objets de données et enregistrer des modèles ou des données.
La valeur par défaut du format de fichier est DXFILEFORMAT_BINARY. 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 un fichier est spécifié en tant que binaire (0) et texte (1), il est enregistré en tant que fichier texte, car la valeur ne peut pas être reconnaissable de la valeur de format de fichier texte (0 + 1 = 1). 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 indiquer binaire et compressé. La définition d’un fichier à compresser sans spécifier de format entraîne un fichier compressé binaire.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi