IStiUSD::RawReadCommand-Methode (stiusd.h)

Die IStiUSD::RawReadCommand-Methode eines Standbildminidrivers liest Befehlsinformationen von einem Standbildgerät.

Syntax

HRESULT RawReadCommand(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

Parameter

lpBuffer

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

lpdwNumberOfBytes

Vom Aufrufer bereitgestellter Zeiger auf ein DWORD. Der Aufrufer lädt das DWORD mit der Anzahl von Bytes im Puffer, auf die von lpBuffer verwiesen wird. Der Treiber muss diesen Wert durch die Anzahl der tatsächlich gelesenen Bytes ersetzen.

lpOverlapped

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

Rückgabewert

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

Hinweise

IStiUSD::RawReadCommand muss nur implementiert werden, wenn Befehls- und Dateninformationen von einem Gerät mit unterschiedlichen Methoden gelesen werden. Für andere Geräte kann IStiUSD::RawReadData sowohl für Befehle als auch für Daten verwendet werden. Wenn der Aufruf nicht implementiert wird, muss er STIERR_UNSUPPORTED zurückgeben.

Die Implementierung dieser Methode sowie die Bedeutung von Pufferinhalten sind vom Anbieter definiert.

Anforderungen

Weitere Informationen

IStiDevice::RawReadCommand

IStiUSD