Metodo IStiUSD::GetStatus (stiusd.h)
Il metodo IStiUSD::GetStatus restituisce lo stato di un dispositivo ancora immagine.
Sintassi
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Parametri
pDevStatus
Puntatore fornito dal chiamante a una struttura STI_DEVICE_STATUS .
Valore restituito
Se l'operazione ha esito positivo, il metodo deve restituire S_OK. In caso contrario, deve restituire uno dei codici di errore prefissi STIERR definiti in stierr.h.
Commenti
Il chiamante fornisce valori per i membri dwSize e StatusMask della struttura STI_DEVICE_STATUS e il minidriver deve fornire valori per il resto dei membri della struttura.
Se il driver ha impostato in precedenza il flag di STI_GENCAP_POLLING_NEEDED nella struttura di STI_DEV_CAPS del dispositivo, il metodo IStiUSD::GetStatus è il mezzo in base al quale il monitoraggio eventi determina se si è verificato un evento Ancora Image Device Events . Il monitoraggio eventi chiamerà il metodo, specificando STI_DEVSTATUS_EVENT_STATE nella struttura STI_DEVICE_STATUS fornita. Il driver deve eseguire il polling del dispositivo e impostare STI_EVENTHANDLING_PENDING se si è verificato un evento.
Se il chiamante specifica STI_DEVSTATUS_ONLINE_STATE nella struttura di STI_DEVICE_STATUS fornita, il minidriver deve impostare il flag appropriato nel membro dwOnlineState della struttura.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | stiusd.h (include Stiusd.h) |