Condividi tramite


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)

Vedere anche

IStiDevice::GetStatus

IStiUSD