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::GetCapabilities