ID3DXFile::CreateSaveObject-Methode

Erstellt ein Speicherobjekt, das zum Speichern von Daten in einer X-Datei verwendet wird.

Syntax

HRESULT CreateSaveObject(
  [in]  LPCVOID               pData,
  [in]  D3DXF_FILESAVEOPTIONS flags,
  [in]  D3DXF_FILEFORMAT      dwFileFormat,
  [out] ID3DXFileSaveObject   **ppSaveObj
);

Parameter

pData [in]

Typ: LPCVOID

Zeiger auf den Namen der Datei, die zum Speichern von Daten verwendet werden soll.

Flags [in]

Typ: D3DXF_FILESAVEOPTIONS

Wert, der den Namen der Datei angibt, in der Daten gespeichert werden sollen. Dieser Wert kann eines der Flags dateispeicherungsoptionen sein.

dwFileFormat [in]

Typ: D3DXF_FILEFORMAT

Gibt das Format an, das beim Speichern der X-Datei verwendet werden soll. Dieser Wert kann eines der Dateiformatflags sein. Weitere Informationen finden Sie in den Hinweisen.

ppSaveObj [out]

Typ: ID3DXFileSaveObject**

Adresse eines Zeigers auf eine ID3DXFileSaveObject-Schnittstelle , die das erstellte Speicherobjekt darstellt.

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_BADVALUE, D3DXFERR_PARSEERROR.

Bemerkungen

Nachdem Sie diese Methode verwendet haben, verwenden Sie methoden der ID3DXFileSaveObject-Schnittstelle , um Datenobjekte zu erstellen und Vorlagen oder Daten zu speichern.

Für das gespeicherte Dateiformat dwFileFormat muss eines der Binär-, Legacy-Binär- oder Textflags in Dateiformaten angegeben werden. Die Datei kann mithilfe des optionalen D3DXF_FILEFORMAT_COMPRESSED-Flags komprimiert werden.

Die Dateiformatwerte können in einem logischen ODER kombiniert werden, um komprimierten Text oder komprimierte Binärdateien zu erstellen. Wenn Sie angeben, dass das Dateiformat Text und komprimiert sein soll, wird die Datei zuerst als Text geschrieben und dann komprimiert. Komprimierte Textdateien sind jedoch nicht so effizient wie binäre Textdateien. in den meisten Fällen sollten Sie daher binär und komprimiert angeben.

Anforderungen

Anforderung	Wert
Header	D3DX9Xof.h
Bibliothek	D3dx9.lib

Siehe auch

ID3DXFile

ID3DXFileSaveObject