Метод IStiUSD::GetStatus (stiusd.h)
Метод iStiUSD::GetStatus изображения по-прежнему возвращает состояние устройства с изображением.
Синтаксис
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Параметры
pDevStatus
Указатель на STI_DEVICE_STATUS структуру, предоставляемую вызывающим абонентом.
Возвращаемое значение
Если операция выполнена успешно, метод должен вернуть S_OK. В противном случае он должен возвращать один из кодов ошибок с префиксом STIERR, определенных в stierr.h.
Замечания
Вызывающий объект предоставляет значения для элементов dwSize и StatusMask членов структуры STI_DEVICE_STATUS, а мини-driver должен предоставлять значения для остальных элементов структуры.
Если драйвер ранее задал флаг STI_GENCAP_POLLING_NEEDED в структуре STI_DEV_CAPS устройства, метод IStiUSD::GetStatus является средством, с помощью которого монитор событий определяет, произошло ли событие События устройства по-прежнему изображения. Монитор событий вызовет метод, указав STI_DEVSTATUS_EVENT_STATE в предоставленной структуре STI_DEVICE_STATUS. Драйвер должен опрашить устройство и задать STI_EVENTHANDLING_PENDING, если произошло событие.
Если вызывающий объект указывает STI_DEVSTATUS_ONLINE_STATE в предоставленной структуре STI_DEVICE_STATUS, мини-driver должен задать соответствующий флаг в элементе dwOnlineStat e структуры.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | stiusd.h (include Stiusd.h) |