Метод IMDSPDeviceControl::GetDCStatus (mswmdm.h)
Метод GetDCStatus извлекает состояние элемента управления устройства.
Синтаксис
HRESULT GetDCStatus(
[out] DWORD *pdwStatus
);
Параметры
[out] pdwStatus
Указатель на DWORD , содержащий состояние элемента управления устройства. Значение состояния элемента управления содержит один или несколько следующих флагов.
| Flag | Описание |
|---|---|
| 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 . |
|
Произошла неизвестная ошибка. |
Комментарии
Этот вызов возвращает значения состояния, относящиеся к операциям управления устройствами этого интерфейса. Состояние элемента управления может предоставлять сведения о состоянии связанных с элементом управления действий устройства, таких как воспроизведение, запись и т. д. Однако он не может предоставить сведения о глобальном состоянии устройства, например о том, загружает ли устройство данные или получает к нему доступ по какой-либо другой причине. Если устройство занято по какой-либо причине, отличной от управления устройством, вы получите код занятости и должны вызвать метод GetStatus связанного интерфейса IMDSPDevice для получения более подробных сведений.
Не следует пытаться вызывать методы Play, Record, Pause, Resume или Stop этого интерфейса, если возвращается значение состояния WMDM_STATUS_BUSY, а значение состояния не содержит других значений из таблицы значений состояния.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | mswmdm.h |
| Библиотека | Mssachlp.lib |