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 |
|
| Bibliothek |
|