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 媒体设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

在尝试与存储介质交互之前,必须始终调用此方法。 如果其他接口调用了正在进行的操作,则返回的状态值WMDM_STATUS_BUSY。 可以评估从此调用返回的值,以确定是否从 IMDSPStorageGlobals 接口调用了正在进行的操作。

必须实现此方法。 它不得返回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 有关详细信息,请参阅 强制接口和可选接口

要求

   
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPStorageGlobals 接口