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