Partager via


Méthode IDirectXFileSaveObject::CreateDataObject

Crée un objet de données. Action déconseillée.

Syntaxe

HRESULT CreateDataObject(
  [in]                REFGUID           rguidTemplate,
  [in]                LPCSTR            szName,
  [in]          const GUID              *pguid,
  [in]                DWORD             cbSize,
  [in]                LPVOID            pvData,
  [out, retval]       LPDIRECTXFILEDATA *ppDataObj
);

Paramètres

rguidTemplate [in]

Type : REFGUID

GUID représentant le modèle de l’objet de données.

szName [in]

Type : LPCSTR

Pointeur vers le nom de l’objet de données. Spécifiez NULL si l’objet n’a pas de nom.

pguid [in]

Type : GUID* const

Pointeur vers un GUID représentant l’objet de données. Spécifiez NULL si l’objet n’a pas de GUID.

cbSize [in]

Type : DWORD

Taille de l’objet de données, en octets.

pvData [in]

Type : LPVOID

Pointeur vers une mémoire tampon contenant toutes les données du membre requis.

ppDataObj [out, retval]

Type : LPDIRECTXFILEDATA*

Adresse d’un pointeur vers une interface IDirectXFileData , représentant l’objet de données de fichier 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 valeurs suivantes. DXFILEERR_BADALLOC DXFILEERR_BADVALUE

Notes

Si un objet de référence de données référence l’objet de données, le paramètre szName ou pguid doit être non NULL.

Enregistrez tous les modèles à l’aide de la méthode IDirectXFileSaveObject::SaveTemplates avant d’enregistrer les données créées par cette méthode. Enregistrez les données créées à l’aide de la méthode IDirectXFileSaveObject::SaveData .

Si vous devez enregistrer des données facultatives, utilisez la méthode IDirectXFileData::AddDataObject après avoir utilisé cette méthode et avant d’utiliser IDirectXFileSaveObject::SaveData. Si l’objet contient des objets enfants, ajoutez-les avant d’appeler IDirectXFileSaveObject::SaveData.

Spécifications

Condition requise Valeur
En-tête
DXFile.h
Bibliothèque
D3dxof.lib

Voir aussi

IDirectXFileSaveObject

IDirectXFileData::AddDataObject

IDirectXFileSaveObject::SaveData

IDirectXFileSaveObject::SaveTemplates