WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, fonction (wdfusb.h)
[S’applique à KMDF et UMDF]
La méthode WdfUsbTargetPipeSetNoMaximumPacketSizeCheck désactive le test de l’infrastructure pour déterminer si la taille de la mémoire tampon de lecture d’un pilote est un multiple de la taille maximale des paquets d’un canal USB.
Syntaxe
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Paramètres
[in] Pipe
Handle d’un objet de canal d’infrastructure obtenu en appelant WdfUsbInterfaceGetConfiguredPipe.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Pour éviter de recevoir des données supplémentaires à partir d’une activité de bus inattendue, qui est parfois appelée babble, les pilotes spécifient généralement des mémoires tampons de lecture qui sont un multiple de la taille maximale des paquets du canal. (Les pilotes reçoivent la taille maximale des paquets d’un canal USB dans une structure WDF_USB_PIPE_INFORMATION .) Par défaut, l’infrastructure signale une erreur si un pilote spécifie une mémoire tampon de lecture qui n’est pas un multiple de la taille de paquet maximale du canal. Si le pilote appelle WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, l’infrastructure ne signale pas d’erreur si une mémoire tampon de lecture n’est pas un multiple de la taille maximale des paquets.
Pour plus d’informations sur la méthode WdfUsbTargetPipeSetNoMaximumPacketSizeCheck et les cibles d’E/S USB, consultez Cibles d’E/S USB.
Exemples
L’exemple de code suivant désactive le test de l’infrastructure pour déterminer si la taille d’une mémoire tampon est un multiple de la taille de paquet maximale d’un canal USB.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfusb.h (inclure Wdfusb.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |