IStiDevice::GetStatus-Methode (sti.h)

Die IStiDevice::GetStatus-Methode gibt die status Informationen eines Standbildgeräts zurück.

Syntax

HRESULT GetStatus(
  [in, out] PSTI_DEVICE_STATUS pDevStatus
);

Parameter

[in, out] pDevStatus

Vom Aufrufer bereitgestellter Zeiger auf eine STI_DEVICE_STATUS-Struktur . Der Aufrufer muss die Elemente dwSize und StatusMask festlegen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird einer der in stierr.h definierten Fehlercodes mit STIERR-Präfix zurückgegeben.

Hinweise

Die IStiDevice::GetStatus-Methode gibt Geräte-status Informationen in der vom Aufrufer bereitgestellten STI_DEVICE_STATUS-Struktur zurück. Die status wird durch Aufrufen von IStiUSD::GetStatus abgerufen, das von vom Hersteller bereitgestellten Minitreibern exportiert wird.

Vor dem Aufrufen von IStiDevice::GetStatus müssen Clients der IStiDevice-COM-SchnittstelleIStillImage::CreateDevice aufrufen, um einen IStiDevice-Schnittstellenzeiger abzurufen, der Zugriff auf ein angegebenes Gerät ermöglicht.

Einem Aufruf von IStiDevice::GetStatus muss ein Aufruf von IStiDevice::LockDevice und gefolgt von einem Aufruf von IStiDevice::UnLockDevice vorangestellt werden.

Anforderungen