Método IStiUSD::GetStatus (stiusd.h)
Un minidriver de imagen fija método IStiUSD::GetStatus devuelve el estado de un dispositivo de imagen todavía.
Sintaxis
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Parámetros
pDevStatus
Puntero proporcionado por el autor de la llamada a una estructura de STI_DEVICE_STATUS.
Valor devuelto
Si la operación se realiza correctamente, el método debe devolver S_OK. De lo contrario, debe devolver uno de los códigos de error con prefijo STIERR definidos en stierr.h.
Observaciones
El llamador proporciona valores para el dwSize y StatusMask miembros de la estructura STI_DEVICE_STATUS y el minidriver debe proporcionar valores para el resto de los miembros de la estructura.
Si el controlador ha establecido previamente la marca STI_GENCAP_POLLING_NEEDED en la estructura de STI_DEV_CAPS del dispositivo, el método IStiUSD::GetStatus es el medio por el que el monitor de eventos determina si se ha producido un Eventos de dispositivo de imagen todavía. El monitor de eventos llamará al método , especificando STI_DEVSTATUS_EVENT_STATE en la estructura STI_DEVICE_STATUS proporcionada. El controlador debe sondear el dispositivo y establecer STI_EVENTHANDLING_PENDING si se ha producido un evento.
Si el autor de la llamada especifica STI_DEVSTATUS_ONLINE_STATE en la estructura STI_DEVICE_STATUS proporcionada, el minidriver debe establecer la marca adecuada en el miembro dwOnlineState de la estructura.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Escritorio |
encabezado de | stiusd.h (incluya Stiusd.h) |