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
Library Mssachlp.lib

另请参阅

IMDSPDevice 接口

IWMDMStorageControl 接口

IWMDMStorageGlobals 接口