Metodo IStiUSD::GetStatus (stiusd.h)
Un minidriver dell'immagine 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 con prefisso STIERR definiti in stierr.h.
Osservazioni
Il chiamante fornisce i valori per il dwSize e StatusMask membri 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 STI_DEV_CAPS del dispositivo, il metodo IStiUSD::GetStatus del minidriver è il modo in cui il monitoraggio eventi determina se si è verificato un Eventi del dispositivo ancora immagine. 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 STI_DEVICE_STATUS fornita, il minidriver deve impostare il flag appropriato nel membro dwOnlineState della struttura.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | stiusd.h (include Stiusd.h) |