IStiUSD::RawReadCommand-Methode (stiusd.h)
Die IStiUSD::RawReadCommand- Methode eines Stillbild-Minidrivers liest Befehlsinformationen von einem stillen Bildgerät aus.
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 der Bytes im Puffer, auf die durch lpBufferverwiesen wird. Der Treiber muss diesen Wert durch die Anzahl der tatsächlich gelesenen Bytes ersetzen.
lpOverlapped
Optionaler, vom Aufrufer bereitgestellter Zeiger auf eine ÜBERLAPPENDE Struktur (in der Microsoft Windows SDK-Dokumentation beschrieben).
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Methode S_OK zurückgeben. Andernfalls sollte eine der STIERR-präfixierten Fehlercodes zurückgegeben werden, die in stierr.hdefiniert sind.
Bemerkungen
Es ist nur erforderlich, IStiUSD::RawReadCommand zu implementieren, wenn Befehls- und Dateninformationen von einem Gerät über verschiedene Methoden gelesen werden. Für andere Geräte können IStiUSD::RawReadData- sowohl für Befehle als auch für Daten verwendet werden. Wenn der Aufruf nicht implementiert ist, muss er STIERR_UNSUPPORTED zurückgeben.
Die Implementierung dieser Methode sowie die Bedeutung von Pufferinhalten sind vom Anbieter definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | stiusd.h (einschließlich Stiusd.h) |