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 dateispeicheroptionen 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, lautet der Rückgabewert S _ OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Sein: D3DXFERR _ BADVALUE, D3DXFERR _ PARSEERROR.

Hinweise

Verwenden Sie nach der Verwendung dieser Methode 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-, Legacybinä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 OR 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