共用方式為


IDirectXFile::CreateSaveObject 方法

建立儲存物件。 已取代。

Syntax

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

參數

szFileName [in]

類型: LPCSTR

要用於儲存資料的檔案名指標。

dwFileFormat [in]

類型: DXFILEFORMAT

指出儲存 DirectX 檔案時要使用的格式。 此值可以是 DXFILE 常數中的其中一個DXFILEFORMAT_xxx旗標。 如需詳細資訊,請參閱<備註>。

ppSaveObj [out, retval]

類型: LPDIRECTXFILESAVEOBJECT*

IDirectXFileSaveObject介面指標的位址,代表建立的儲存物件。

傳回值

類型: HRESULT

如果方法成功,傳回值會DXFILE_OK。 如果方法失敗,傳回值可以是下列其中一項:DXFILEERR_BADALLOC、DXFILEERR_BADFILE DXFILEERR_BADVALUE。

備註

使用此方法之後,請使用 IDirectXFileSaveObject 介面的方法來建立資料物件,以及儲存範本或資料。

檔案格式的預設值為 DXFILEFORMAT_BINARY。 檔案格式值可以結合在邏輯 OR 中,以建立壓縮的文字或壓縮的二進位檔案。 如果檔案同時指定為二進位 (0) 和文字 (1) ,則會將它儲存為文字檔,因為此值會從文本檔案格式值 (0 + 1 = 1) 中區分。 如果您指出檔案格式應該是文字並壓縮,則檔案會先寫出為文字,然後再壓縮。 不過,壓縮的文字檔與二進位文字檔不相同,因此在大部分情況下,您會想要指出二進位和壓縮。 將檔案設定為壓縮,而不指定格式會導致二進位壓縮檔案。

規格需求

需求
標頭
DXFile.h
程式庫
D3dxof.lib

另請參閱

IDirectXFile

IDirectXFileSaveObject