IStiUSD::GetStatus-Methode (stiusd.h)

  • Artikel

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)

Weitere Informationen

IStiDevice::GetStatus

IStiUSD