IMDSPDeviceControl::GetDCStatus 方法 (mswmdm.h)
GetDCStatus 方法检索设备的控制状态。
语法
HRESULT GetDCStatus(
[out] DWORD *pdwStatus
);
参数
[out] pdwStatus
指向包含设备的控制状态的 DWORD 的指针。 控件状态值包含以下一个或多个标志。
标志 | 描述 |
---|---|
WMDM_STATUS_READY | Windows Media 设备管理器及其子组件处于就绪状态。 |
WMDM_STATUS_BUSY | 当前正在执行操作。 评估其他状态值以确定它是哪个操作。 |
WMDM_STATUS_DEVICECONTROL_PLAYING | 设备当前正在播放。 |
WMDM_STATUS_DEVICECONTROL_RECORDING | 设备当前正在录制。 |
WMDM_STATUS_DEVICECONTROL_PAUSED | 设备当前已暂停。 |
WMDM_STATUS_DEVICECONTROL_REMOTE | 设备的播放或录制操作由应用程序远程控制。 |
WMDM_STATUS_DEVICECONTROL_STREAM | 播放或录制方法是将数据流式传输到媒体设备或从媒体设备流式传输数据。 |
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
pdwStatus 参数是无效的或 NULL 指针。 |
|
发生了未指定的错误。 |
注解
此调用返回特定于此接口的设备控制操作的状态值。 控制状态可以提供有关设备控制相关活动的状态的信息,例如播放、录制等。 但是,它无法提供有关设备全局状态的信息,例如设备是正在下载数据还是由于某种其他原因而访问。 如果设备由于设备控制以外的任何原因而忙,则会收到忙代码,并且必须调用关联 IMDSPDevice 接口的 GetStatus 方法以获取更多详细信息。
如果返回状态值WMDM_STATUS_BUSY且状态值不包含状态值表中的任何其他值,则不得尝试调用此接口的 Play、 Record、 Pause、 Resume 或 Stop 方法。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |