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 aufweist.

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, wird der Rückgabewert S_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Sein: D3DXFERR_BADOBJECT, DXFILEERR_BADVALUE, E_OUTOFMEMORY.

Bemerkungen

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

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

Anforderungen

Siehe auch

ID3DXFileSaveObject