Función WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)

  • Artículo

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

Consulte también

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe