IStiDevice::RawReadCommand-Methode (sti.h)

Die IStiDevice::RawReadCommand-Methode liest Befehlsinformationen von einem Standbildgerät.

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 lpBuffer verweist. Bei der Rückgabe enthält sie die Anzahl der tatsächlich gelesenen Bytes.

[in, optional] lpOverlapped

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

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::RawReadCommand-Methode ruft IStiUSD::RawReadCommand auf, die von vom Anbieter bereitgestellten Minidrivern 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 mit verschiedenen Methoden gelesen werden. Für andere Geräte kann IStiDevice::RawReadData sowohl für Befehle als auch für Daten verwendet werden.

Vor dem Aufrufen von IStiDevice::RawReadCommand 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::RawReadCommand muss ein Aufruf von IStiDevice::LockDevice und gefolgt von einem Aufruf von IStiDevice::UnLockDevice vorangestellt werden.

Anforderungen