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 de paquet maximale d’un canal USB.
Syntaxe
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Paramètres
[in] Pipe
Handle vers un objet de canal d’infrastructure obtenu en appelant WdfUsbInterfaceGetConfiguredPipe.
Valeur de retour
Aucun
Remarques
Une vérification de bogue 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, 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 du paquet du canal. (Les pilotes reçoivent la taille maximale du paquet 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 du paquet.
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);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfusb.h (include 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) |