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