共用方式為


IMDSPStorageGlobals::Initialize 方法 (mswmdm.h)

Initialize 方法會格式化儲存媒體。 這個方法是一個選擇項目。 不過,如果裝置支援這項功能,就應該實作這個方法。 如果未實作此方法,除了任何其他旗標之外, IMDSPStorageGlobals::GetCapabilities 還必須傳回WMDM_STORAGECAP_NOT_INITIALIZABLE。 如需詳細資訊,請參閱 強制和選擇性介面

語法

HRESULT Initialize(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

參數

[in] fuMode

用來初始化媒體的模式。 指定下列兩種模式的其中一個。 如果同時指定這兩種模式,則會使用區塊模式。

模式 Description
WMDM_MODE_BLOCK 作業是使用區塊模式處理來執行。 在作業完成之前,不會傳回呼叫。
WMDM_MODE_THREAD 作業是使用線程模式處理來執行。 呼叫會立即傳回,且作業會在背景線程中執行。

[in] pProgress

應用程式所實作之 IWMDMProgress 介面的指標,以追蹤格式化作業的進度。 此參數可以是 Null

傳回值

方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:

  • 標準 COM 錯誤碼
  • 轉換成 HRESULT 值的 Windows 錯誤碼
  • Windows Media 裝置管理員 錯誤碼
如需可能錯誤碼的廣泛清單,請參閱 錯誤碼

備註

如果指定WMDM_MODE_BLOCK,則除非格式化完成, 否則 Initialize 不會傳回。 如果指定WMDM_MODE_THREAD,呼叫會立即傳回,而呼叫端可以使用 IMDSPStorageGlobals::GetStatus 方法來追蹤初始化作業。

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

IMDSPStorageGlobals 介面

IMDSPStorageGlobals::GetCapabilities

IMDSPStorageGlobals::GetStatus

IWMDMProgress 介面