Función WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)
[Se aplica a KMDF y UMDF]
El método WdfUsbTargetPipeSetNoMaximumPacketSizeCheck deshabilita la prueba del marco de si el tamaño del búfer de lectura de un controlador es un múltiplo del tamaño máximo de paquete de una canalización USB.
Sintaxis
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Parámetros
[in] Pipe
Identificador de un objeto de canalización de marco que se obtuvo mediante una llamada a WdfUsbInterfaceGetConfiguredPipe.
Valor devuelto
None
Observaciones
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Para evitar recibir datos adicionales de la actividad inesperada del bus, que a veces se denomina babble, los controladores suelen especificar búferes de lectura que son un múltiplo del tamaño máximo de paquete de la canalización. (Los controladores reciben el tamaño máximo de paquete de una canalización USB en una estructura de WDF_USB_PIPE_INFORMATION ). De forma predeterminada, el marco notifica un error si un controlador especifica un búfer de lectura que no es un múltiplo del tamaño máximo de paquete de la canalización. Si el controlador llama a WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, el marco no notifica un error si un búfer de lectura no es un múltiplo del tamaño máximo del paquete.
Para obtener más información sobre el método WdfUsbTargetPipeSetNoMaximumPacketSizeCheck y los destinos de E/S USB, consulte Destinos de E /S USB.
Ejemplos
En el ejemplo de código siguiente se deshabilita la prueba del marco de si el tamaño de un búfer es un múltiplo del tamaño máximo de paquete de una canalización USB.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Universal |
Versión mínima de KMDF | 1.0 |
Versión mínima de UMDF | 2.0 |
Encabezado | wdfusb.h (incluya Wdfusb.h) |
Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |