WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, fonction (wdfusb.h)

  • Article

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

Voir aussi

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe