WdfUsbTargetPipeSetNoMaximumPacketSizeCheck-Funktion (wdfusb.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfUsbTargetPipeSetNoMaximumPacketSizeCheck-Methode deaktiviert den Test des Frameworks, ob die Größe des Lesepuffers eines Treibers ein Vielfaches der maximalen Paketgröße einer USB-Pipe ist.

Syntax

void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
  [in] WDFUSBPIPE Pipe
);

Parameter

[in] Pipe

Ein Handle für ein Framework-Pipeobjekt, das durch aufrufen von WdfUsbInterfaceGetConfiguredPipe abgerufen wurde.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Um zu vermeiden, dass zusätzliche Daten von unerwarteten Busaktivitäten empfangen werden, die manchmal als Babble bezeichnet werden, geben Treiber normalerweise Lesepuffer an, die ein Vielfaches der maximalen Paketgröße der Pipe darstellen. (Treiber erhalten die maximale Paketgröße einer USB-Pipe in einer WDF_USB_PIPE_INFORMATION-Struktur .) Standardmäßig meldet das Framework einen Fehler, wenn ein Treiber einen Lesepuffer angibt, der kein Vielfaches der maximalen Paketgröße der Pipe ist. Wenn der Treiber WdfUsbTargetPipeSetNoMaximumPacketSizeCheck aufruft, meldet das Framework keinen Fehler, wenn ein Lesepuffer kein Vielfaches der maximalen Paketgröße ist.

Weitere Informationen zur WdfUsbTargetPipeSetNoMaximumPacketSizeCheck-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Im folgenden Codebeispiel wird der Test des Frameworks deaktiviert, ob die Größe eines Puffers ein Vielfaches der maximalen Paketgröße einer USB-Pipe ist.

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfusb.h (einschließlich Wdfusb.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe