Freigeben über


IStiUSD::GetStatus-Methode (stiusd.h)

Die IStiUSD::GetStatus-Methode eines Stillbildgeräts gibt den Status eines stillen Bildgerä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 eine der STIERR-präfixierten Fehlercodes zurückgegeben werden, die in stierr.hdefiniert sind.

Bemerkungen

Der Aufrufer stellt Werte für die dwSize und StatusMask Member der STI_DEVICE_STATUS Struktur bereit, und der Minidriver muss Werte für die restlichen Strukturmmber angeben.

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 Minidrivers das Mittel, mit dem der Ereignismonitor bestimmt, ob ein Still Image Device Events aufgetreten ist. Der Ereignismonitor ruft die Methode auf, wobei STI_DEVSTATUS_EVENT_STATE in der angegebenen STI_DEVICE_STATUS-Struktur angegeben wird. Der Treiber muss das Gerät abrufen und STI_EVENTHANDLING_PENDING festlegen, wenn ein Ereignis aufgetreten ist.

Wenn der Aufrufer STI_DEVSTATUS_ONLINE_STATE in der bereitgestellten STI_DEVICE_STATUS-Struktur angibt, sollte der Minidriver das entsprechende Flag im dwOnlineState Member der Struktur festlegen.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- stiusd.h (einschließlich Stiusd.h)

Siehe auch

IStiDevice::GetStatus

IStiUSD-