WdfUsbTargetPipeSetNoMaximumPacketSizeCheck-Funktion (wdfusb.h)
[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 eines USB-Pipes ist.
Syntax
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Parameter
[in] Pipe
Ein Handle zu einem Framework-Pipeobjekt, das durch Aufrufen WdfUsbInterfaceGetConfiguredPipeabgerufen wurde.
Rückgabewert
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Um zu vermeiden, dass zusätzliche Daten von unerwarteten Busaktivitäten empfangen werden, die manchmal als babblebezeichnet werden, geben Treiber in der Regel Lesepuffer an, die ein Vielfaches der maximalen Paketgröße der Pipe sind. (Treiber erhalten die maximale Paketgröße eines USB-Pipes 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 WdfUsbTargetPipeSetNoMaximumPacketSizeCheckaufruft, meldet das Framework keinen Fehler, wenn ein Lesepuffer kein Vielfaches der maximalen Paketgröße ist.
Weitere Informationen zu den 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 eines USB-Pipes ist.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfusb.h (include Wdfusb.h) |
| Library | 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) |