ID3DXFileSaveObject::AddDataObject-Methode

Fügt ein Datenobjekt als untergeordnetes Element des ID3DXFileSaveData-Objekts hinzu.

Syntax

HRESULT AddDataObject(
  [in]               REFGUID           rguidTemplate,
  [in]               LPCSTR            szName,
  [in]         const GUID              *pId,
  [in]               SIZE_T            cbSize,
  [in]               LPCVOID           pvData,
  [in, retval]       ID3DXFileSaveData **ppObj
);

Parameter

rguidTemplate [ In]

Typ: REFGUID

GUID, die die Vorlage des Datenobjekts darstellt.

szName [ In]

Typ: LPCSTR

Zeiger auf den Namen des Datenobjekts. Geben Sie NULL an, wenn das Objekt keinen Namen hat.

pId [ In]

Typ: const GUID *

Zeiger auf eine GUID, die das Datenobjekt darstellt. Geben Sie NULL an, wenn das Objekt keine GUID hat.

cbSize [ In]

Typ: SIZE _ T

Größe des Datenobjekts in Bytes.

pvData [ In]

Typ: LPCVOID

Zeiger auf einen Puffer, der alle erforderlichen Daten im Datenobjekt enthält.

ppObj [ in, retval]

Typ: ID3DXFileSaveData**

Adresse eines Zeigers auf eine ID3DXFileSaveData-Schnittstelle, die den Dateidatenknoten darstellt, dem das Datenobjekt hinzugefügt wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, ist der Rückgabewert S _ OK. Wenn bei der Methode ein Fehler auftritt, kann der Rückgabewert einer der folgenden Sein: D3DXFERR _ BADOBJECT, DXFILEERR _ BADVALUE, E _ OUTOFMEMORY.

Hinweise

Wenn ein Datenverweisobjekt auf das Datenobjekt verweist, muss der szName- oder pId-Parameter nicht NULL sein.

Speichern Sie die erstellten Daten mithilfe der ID3DXFileSaveObject::Save-Methode auf dem Datenträger.

Anforderungen

Anforderung Wert
Header
D3DX9Xof.h
Bibliothek
D3dx9.lib

Weitere Informationen

ID3DXFileSaveObject