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