IWMDMStorageGlobals::GetStatus 方法 (mswmdm.h)
GetStatus 方法會擷取儲存媒體的目前狀態。
語法
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
參數
[out] pdwStatus
當方法傳回時,要接收狀態資訊的 DWORD 指標。 下列值可以在 pdwStatus 參數中傳回。
狀態 | 描述 |
---|---|
WMDM_STATUS_READY | 媒體處於閑置或就緒狀態。 |
WMDM_STATUS_BUSY | 作業正在進行中。 評估狀態值以判斷進行中的作業。 |
WMDM_STATUS_STORAGE_NOTPRESENT | 儲存媒體不存在。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面回報。 |
WMDM_STATUS_STORAGE_INITIALIZING | 裝置目前正忙於將裝置上的儲存媒體格式化。 |
WMDM_STATUS_STORAGE_BROKEN | 儲存媒體已中斷。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面回報。 |
WMDM_STATUS_STORAGE_NOTSUPPORTED | 裝置不支援儲存媒體。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面傳回。 |
WMDM_STATUS_STORAGE_UNFORMATTED | 儲存媒體的格式不正確。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面回報。 |
傳回值
方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
備註
呼叫端嘗試與儲存媒體互動之前,必須一律呼叫這個方法。 如果某些其他介面已叫用進行中的作業,則會WMDM_STATUS_BUSY擷取的狀態值。 您可以評估從這個呼叫擷取的值,以判斷是否已從 IWMDMStorageGlobals 介面叫用進行中的作業。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |