IDirectXFile::CreateSaveObject-Methode

Erstellt ein Speicherobjekt. Veraltet.

Syntax

HRESULT CreateSaveObject(
  [in]          LPCSTR                  szFileName,
  [in]          DXFILEFORMAT            dwFileFormat,
  [out, retval] LPDIRECTXFILESAVEOBJECT *ppSaveObj
);

Parameter

szFileName [ In]

Typ: LPCSTR

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

dwFileFormat [ In]

Typ: DXFILEFORMAT

Gibt das Format an, das beim Speichern der DirectX-Datei verwendet werden soll. Dieser Wert kann eines der DXFILEFORMAT _ xxx-Flags in DXFILE-Konstanten sein. Weitere Informationen finden Sie in den Hinweisen.

ppSaveObj [ out, retval]

Typ: LPDIRECTXFILESAVEOBJECT*

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

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, lautet der Rückgabewert DXFILE _ OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden Sein: DXFILEERR _ BADALLOC, DXFILEERR _ BADFILE, DXFILEERR _ BADVALUE.

Bemerkungen

Verwenden Sie nach der Verwendung dieser Methode Methoden der IDirectXFileSaveObject-Schnittstelle, um Datenobjekte zu erstellen und Vorlagen oder Daten zu speichern.

Der Standardwert für das Dateiformat ist DXFILEFORMAT _ BINARY. Die Dateiformatwerte können in einem logischen OR kombiniert werden, um komprimierten Text oder komprimierte Binärdateien zu erstellen. Wenn eine Datei sowohl als Binärdatei (0) als auch als Text (1) angegeben wird, wird sie als Textdatei gespeichert, da der Wert vom Textdateiformatwert (0 + 1 = 1) nicht unterschieden werden kann. 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, sodass Sie in den meisten Fällen binäre und komprimierte Dateien angeben möchten. Wenn Sie festlegen, dass eine Datei komprimiert werden soll, ohne ein Format anzugeben, wird eine binäre, komprimierte Datei verwendet.

Requirements (Anforderungen)

Anforderung Wert
Header
DXFile.h
Bibliothek
D3dxof.lib

Weitere Informationen

IDirectXFile

IDirectXFileSaveObject