IStiUSD::RawReadData-Methode (stiusd.h)

  • Artikel

Die IStiUSD::RawReadData-Methode eines Standbildminidrivers liest Daten von einem Standbildgerä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 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

Ein Standbildminidriver implementiert diese Methode in der Regel durch Aufrufen von ReadFile (in der Windows SDK-Dokumentation beschrieben).

Bei USB-Geräten kann eine bessere Leistung erzielt werden, wenn Leseanforderungen an die Grenzen der maximalen Paketgröße ausgerichtet werden. Die maximalen Paketgrößen können abgerufen werden, indem Sie DeviceIoControl aufrufen und den IOCTL_GET_CHANNEL_ALIGN_RQST E/A-Steuerungscode angeben.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile stiusd.h (einschließlich Stiusd.h)

Weitere Informationen

IStiDevice::RawReadData

IStiUSD