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, wird 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
Nachdem Sie diese Methode verwendet haben, verwenden Sie 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är (0) als auch als Text (1) angegeben ist, wird sie als Textdatei gespeichert, da der Wert nicht vom Wert des Textdateiformats (0 + 1 = 1) zu unterscheiden ist. Wenn Sie angeben, dass das Dateiformat Text und komprimiert sein soll, wird die Datei zuerst als Text ausgeschrieben und dann komprimiert. Komprimierte Textdateien sind jedoch nicht so effizient wie binäre Textdateien, sodass Sie in den meisten Fällen binär und komprimiert angeben möchten. Wenn Sie festlegen, dass eine Datei komprimiert wird, ohne ein Format anzugeben, führt dies zu einer binären, komprimierten Datei.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch