IDirectXFileSaveObject :: CreateDataObject, méthode

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 [ dans]

Type : REFGUID

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

szName [ dans]

Type : LPCSTR

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

pguid [ dans]

Type : const GUID *

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

cbSize [ dans]

Type : DWORD

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

pvData [ dans]

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 est réussie, 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

Remarques

Si un objet de référence de données fait référence à l’objet de données, le paramètre szName ou pguid doit avoir une valeur non null.

Enregistrez 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 a des objets enfants, ajoutez-les avant d’appeler IDirectXFileSaveObject :: SaveData.

Configuration requise

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

Voir aussi

IDirectXFileSaveObject

IDirectXFileData::AddDataObject

IDirectXFileSaveObject :: SaveData

IDirectXFileSaveObject::SaveTemplates