IStiUSD::RawReadData-Methode (stiusd.h)
Die IStiUSD::RawReadData-Methode eines stillen Bilds liest daten von einem stillen Bildgerät.
Syntax
HRESULT RawReadData(
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
Ein stilles Image-Minidriver implementiert diese Methode in der Regel, indem ReadFile- aufgerufen wird (in der Windows SDK-Dokumentation beschrieben).
Bei USB-Geräten kann eine bessere Leistung erzielt werden, wenn Leseanforderungen an maximale Paketgrößengrenzen ausgerichtet sind. Maximale Paketgrößen können durch Aufrufen DeviceIoControl-abgerufen werden, wobei der IOCTL_GET_CHANNEL_ALIGN_RQST E/A-Steuerelementcode angegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | stiusd.h (einschließlich Stiusd.h) |