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
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | stiusd.h (einschließlich Stiusd.h) |