IStiUSD::GetStatus-Methode (stiusd.h)
Die IStiUSD::GetStatus-Methode eines Standbildminidrivers gibt die status eines Standbildgeräts zurück.
Syntax
HRESULT GetStatus(
PSTI_DEVICE_STATUS pDevStatus
);
Parameter
pDevStatus
Vom Aufrufer bereitgestellter Zeiger auf eine STI_DEVICE_STATUS-Struktur .
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Methode S_OK zurückgeben. Andernfalls sollte einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben werden.
Hinweise
Der Aufrufer stellt Werte für die dwSize - und StatusMask-Member der STI_DEVICE_STATUS-Struktur bereit, und der Minitreiber muss Werte für die restlichen Strukturmember bereitstellen.
Wenn der Treiber zuvor das STI_GENCAP_POLLING_NEEDED-Flag in der STI_DEV_CAPS-Struktur des Geräts festgelegt hat, ist die IStiUSD::GetStatus-Methode des Minitreibers das Mittel, mit dem der Ereignismonitor ermittelt, ob ein Still Image Device Events aufgetreten ist. Der Ereignismonitor ruft die -Methode auf und gibt STI_DEVSTATUS_EVENT_STATE in der angegebenen STI_DEVICE_STATUS-Struktur an. Der Treiber muss das Gerät abfragen und STI_EVENTHANDLING_PENDING festlegen, ob ein Ereignis aufgetreten ist.
Wenn der Aufrufer STI_DEVSTATUS_ONLINE_STATE in der angegebenen STI_DEVICE_STATUS-Struktur angibt, sollte der Minitreiber das entsprechende Flag im dwOnlineState-Element der Struktur festlegen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | stiusd.h (einschließlich Stiusd.h) |