IStiUSD::RawWriteCommand-Methode (stiusd.h)
Die IStiDevice::RawWriteCommand-Methode eines Standbildminidrivers sendet Befehlsinformationen an ein Standbildgerät.
Syntax
HRESULT RawWriteCommand(
LPVOID lpBuffer,
DWORD nNumberOfBytes,
LPOVERLAPPED lpOverlapped
);
Parameter
lpBuffer
Vom Aufrufer bereitgestellter Zeiger auf einen Puffer, der Daten enthält, die an das Gerät gesendet werden sollen.
nNumberOfBytes
Vom Aufrufer angegebene Anzahl der zu schreibenden Bytes. Dies ist die Anzahl der Bytes im Puffer, auf die von lpBuffer verwiesen wird.
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
Es ist nur erforderlich, IStiUSD::RawWriteCommand aufzurufen, wenn Befehle und Daten mit unterschiedlichen Methoden auf ein Gerät geschrieben werden. Für andere Geräte kann IStiUSD::RawWriteData 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) |