共用方式為


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

另請參閱

IMDSPDevice 介面

IWMDMStorageControl 介面

IWMDMStorageGlobals 介面