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