WinUsb_ReadIsochPipeAsap-Funktion (winusb.h)
Die WinUsb_ReadIsochPipeAsap-Funktion sendet eine Anforderung, die Daten von einem isochronen IN-Endpunkt liest.
Syntax
BOOL WinUsb_ReadIsochPipeAsap(
[in] WINUSB_ISOCH_BUFFER_HANDLE BufferHandle,
[in] ULONG Offset,
[in] ULONG Length,
[in] BOOL ContinueStream,
[in] ULONG NumberOfPackets,
PUSBD_ISO_PACKET_DESCRIPTOR IsoPacketDescriptors,
[in, optional] LPOVERLAPPED Overlapped
);
Parameter
[in] BufferHandle
Ein undurchsichtiges Handle für den Übertragungspuffer, der von einem vorherigen Aufruf von WinUsb_RegisterIsochBuffer registriert wurde.
[in] Offset
Offset in den Puffer relativ zum Start der Übertragung.
[in] Length
Länge des Übertragungspuffers in Bytes.
[in] ContinueStream
Gibt an, dass die Übertragung nur übermittelt werden soll, wenn sie im ersten Frame nach der letzten ausstehenden Übertragung geplant werden kann.
[in] NumberOfPackets
Gesamtanzahl der isochronen Pakete, die zum Halten des Übertragungspuffers erforderlich sind. Gibt auch die Anzahl der Elemente im Array an, auf die von IsoPacketDescriptors verwiesen wird.
IsoPacketDescriptors
Ein Array von USBD_ISO_PACKET_DESCRIPTOR , das die Details jedes isochronen Pakets in der Übertragung empfängt.
[in, optional] Overlapped
Zeiger auf eine OVERLAPPED-Struktur , die für asynchrone Vorgänge verwendet wird.
Rückgabewert
WinUsb_ReadIsochPipeAsap gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion FALSE zurück, und der Aufrufer kann den protokollierten Fehler abrufen, indem er GetLastError aufruft.
Wenn der Aufrufer ContinueStream auf TRUE festlegt, schlägt die Übertragung fehl, wenn Winusb.sys die Übertragung nicht planen kann, um den Stream fortzusetzen, ohne einen oder mehrere Frames zu löschen.
Bemerkungen
WinUsb_ReadIsochPipeAsap ermöglicht es dem USB-Treiberstapel, die Startframenummer für die Übertragung auszuwählen. Wenn eine oder mehrere Übertragungen für den Endpunkt bereits ausstehen, wird die Übertragung für die Framenummer geplant, die unmittelbar auf die letzte Framenummer der letzten derzeit ausstehenden Übertragung folgt.
WinUsb_ReadIsochPipeAsap paketiert den Übertragungspuffer, sodass der Host in jedem Intervall die maximal zulässigen Bytes pro Intervall empfangen kann. Die maximalen Bytes werden vom Endpunktdeskriptor für Voll- und Hochgeschwindigkeitsendpunkte und vom Endpunktbegleiterdeskriptor für SuperSpeed-Endpunkte angegeben. Wenn der Aufrufer mehrere Leseanforderungen übermittelt, um Daten vom Gerät zu streamen, sollte die Übertragungsgröße ein Vielfaches der maximalen Bytes pro Intervall (wie von WinUsb_QueryPipeEx zurückgegeben) * 8 / Intervall betragen.
Aufgrund der Übertragungsverpackung, die in der zugrunde liegenden Kernelmodusschnittstelle verwendet wird, beträgt die niedrigste Latenzbenachrichtigung für eine Anwendung oder einen Treiber Intervalle von 1 ms.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Universell |
| Header | winusb.h (einschließlich Winusb.h) |
| Bibliothek | Winusb.lib |
| DLL | Winusb.dll |
Siehe auch
Senden isochroner USB-Übertragungen aus einer WinUSB-Desktop-App