IStiDevice::GetStatus-Methode (sti.h)

Die IStiDevice::GetStatus-Methode gibt die Statusinformationen eines Stillbildgerä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 dwSize und StatusMask Mitglieder festlegen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Methode S_OK zurück. Andernfalls wird eine der STIERR-Präfixfehlercodes zurückgegeben, die in stierr.hdefiniert sind.

Bemerkungen

Die IStiDevice::GetStatus-Methode gibt Gerätestatusinformationen in der vom Aufrufer bereitgestellten STI_DEVICE_STATUS Struktur zurück. Der Status wird durch Aufrufen von IStiUSD::GetStatusabgerufen, das von vom Hersteller bereitgestellten Minidrivern exportiert wird.

Vor dem Aufrufen IStiDevice::GetStatusmüssen Clients der IStiDevice- COM-Schnittstelle IStillImage::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::UnLockDevicevorausgehen.

Anforderungen