WinUsb_ReadIsochPipeAsap, fonction (winusb.h)

  • Article

La fonction WinUsb_ReadIsochPipeAsap envoie une requête qui lit les données d’un point de terminaison IN isochronous.

Syntaxe

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
);

Paramètres

[in] BufferHandle

Handle opaque pour la mémoire tampon de transfert qui a été inscrite par un appel précédent à WinUsb_RegisterIsochBuffer.

[in] Offset

Décalage dans la mémoire tampon par rapport au début du transfert.

[in] Length

Longueur en octets de la mémoire tampon de transfert.

[in] ContinueStream

Indique que le transfert ne doit être envoyé que s’il peut être planifié dans la première image après le dernier transfert en attente.

[in] NumberOfPackets

Nombre total de paquets isochroniques requis pour contenir la mémoire tampon de transfert. Indique également le nombre d’éléments dans le tableau pointé par IsoPacketDescriptors.

IsoPacketDescriptors

Tableau de USBD_ISO_PACKET_DESCRIPTOR qui reçoit les détails de chaque paquet isochroque dans le transfert.

[in, optional] Overlapped

Pointeur vers une structure OVERLAPPED utilisée pour les opérations asynchrones.

Valeur retournée

WinUsb_ReadIsochPipeAsap retourne TRUE si l’opération réussit. Sinon, cette fonction retourne FALSE et l’appelant peut récupérer l’erreur journalisée en appelant GetLastError.

Si l’appelant définit ContinueStream sur TRUE, le transfert échoue si Winusb.sys ne parvient pas à planifier le transfert pour continuer le flux sans supprimer une ou plusieurs images.

Remarques

WinUsb_ReadIsochPipeAsap permet à la pile de pilotes USB de choisir le numéro de cadre de départ pour le transfert. Si un ou plusieurs transferts sont déjà en attente sur le point de terminaison, le transfert est planifié pour le numéro de trame immédiatement après le dernier numéro de trame du dernier transfert actuellement en attente.

WinUsb_ReadIsochPipeAsap paquete la mémoire tampon de transfert afin que dans chaque intervalle, l’hôte puisse recevoir le nombre maximal d’octets autorisés par intervalle. Le nombre maximal d’octets est spécifié par le descripteur de point de terminaison pour les points de terminaison complets et haut débit, et par le descripteur de compagnon de point de terminaison pour les points de terminaison SuperSpeed. Si l’appelant envoie plusieurs demandes de lecture pour diffuser des données à partir de l’appareil, la taille de transfert doit être un multiple des octets maximum par intervalle (comme retourné par WinUsb_QueryPipeEx) * 8 / intervalle.

En raison de l’empaquetage de transfert utilisé dans l’interface en mode noyau sous-jacente, la notification de latence la plus faible à une application ou à un pilote est d’intervalles de 1 ms.

Configuration requise

   
Client minimal pris en charge Windows 8.1
Serveur minimal pris en charge Windows Server 2012 R2
Plateforme cible Universal
En-tête winusb.h (inclure Winusb.h)
Bibliothèque Winusb.lib
DLL Winusb.dll

Voir aussi

Envoyer des transferts isochrones USB à partir d’une application de bureau WinUSB

Fonctions WinUSB