IStiDevice::RawReadCommand-Methode (sti.h)

Artikel
02/07/2025

Die IStiDevice::RawReadCommand Methode liest Befehlsinformationen von einem Stillbildgerät aus.

Syntax

HRESULT RawReadCommand(
  [in, out]      LPVOID       lpBuffer,
  [in, out]      LPDWORD      lpdwNumberOfBytes,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parameter

[in, out] lpBuffer

Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, um vom Gerät gelesene Daten zu empfangen.

[in, out] lpdwNumberOfBytes

Vom Aufrufer bereitgestellter Zeiger auf ein DWORD. Der Aufrufer muss das DWORD mit der Anzahl der Bytes im Puffer laden, auf die durch lpBuffer-verwiesen wird. Bei der Rückgabe enthält sie die Anzahl der tatsächlich gelesenen Bytes.

[in, optional] lpOverlapped

Optionaler, vom Aufrufer bereitgestellter Zeiger auf eine ÜBERLAPPENDE Struktur (in der Microsoft Windows SDK-Dokumentation beschrieben).

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::RawReadCommand-Methode ruft IStiUSD::RawReadCommandauf, die von einem Hersteller bereitgestellte Minidriver exportiert wird. Die Bedeutung von Pufferinhalten ist vom Anbieter definiert.

Es ist nur erforderlich, IStiDevice::RawReadCommand aufzurufen, wenn Befehls- und Dateninformationen von einem Gerät über verschiedene Methoden gelesen werden. Für andere Geräte können IStiDevice::RawReadData- sowohl für Befehle als auch für Daten verwendet werden.

Vor dem Aufrufen IStiDevice::RawReadCommandmü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::RawReadCommand- muss ein Aufruf von IStiDevice::LockDevice und gefolgt von einem Aufruf von IStiDevice::UnLockDevicevorausgehen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	sti.h (einschließlich Sti.h)

Freigeben über