IMDSPDevice::GetStatus 方法 (mswmdm.h)
GetStatus 方法會擷取裝置可以提供的所有裝置狀態資訊。
語法
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
參數
[out] pdwStatus
接收目前裝置狀態之 DWORD 的指標。 下表定義這些狀態值。
狀態 | 描述 |
---|---|
WMDM_STATUS_READY | Windows Media 裝置管理員 及其子元件處於就緒狀態。 |
WMDM_STATUS_BUSY | 作業正在進行中。 檢查其他狀態值,以判斷其為哪個作業。 |
WMDM_STATUS_DEVICE_NOTPRESENT | 裝置未連線到電腦。 |
WMDM_STATUS_STORAGE_NOTPRESENT | 媒體不存在。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面回報。 |
WMDM_STATUS_STORAGE_INITIALIZING | 裝置目前正忙於格式化裝置上的媒體。 |
WMDM_STATUS_STORAGE_BROKEN | 媒體無法運作。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面回報。 |
WMDM_STATUS_STORAGE_NOTSUPPORTED | 裝置不支持媒體。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面傳回。 |
WMDM_STATUS_STORAGE_UNFORMATTED | 媒體格式不正確。 對於支援多個媒體的裝置,此值只會從 IWMDMStorageGlobals 介面傳回。 |
WMDM_STATUS_STORAGECONTROL_INSERTING | IWMDMStorageControl::Insert 方法目前正在執行。 |
WMDM_STATUS_STORAGECONTROL_DELETING | IWMDMStorageControl::D elete 方法目前正在執行。 |
WMDM_STATUS_STORAGECONTROL_MOVING | IWMDMStorageControl::Move 方法目前正在執行。 |
WMDM_STATUS_STORAGECONTROL_READING | IWMDMStorageControl::Read 方法目前正在執行。 |
傳回值
方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
備註
您可以從這個呼叫傳回一或多個狀態值。 媒體裝置所有介面的所有狀態值都會透過此呼叫報告。 例如,如果記憶體作業,例如將檔案寫入媒體裝置正在進行中,此方法的呼叫會報告該作業的忙碌狀態。 對於任何進行中的作業,狀態值WMDM_STATUS_BUSY一律存在。
這個方法必須實作。 它不得傳回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 如需詳細資訊,請參閱 強制和選擇性介面。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |