Поделиться через


Функция WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)

[Применимо к KMDF и UMDF]

Метод WdfUsbTargetPipeSetNoMaximumPacketSizeCheck отключает проверку платформы о том, является ли размер буфера чтения драйвера несколькими из максимального размера пакета USB-канала.

Синтаксис

VOID WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
  [in] WDFUSBPIPE Pipe
);

Параметры

[in] Pipe

Дескриптор объекта канала платформы, полученный путем вызова WdfUsbInterfaceGetConfiguredPipe.

Возвращаемое значение

Никакой

Замечания

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Чтобы избежать получения дополнительных данных из непредвиденного действия шины, который иногда называется лепетчатой, драйверы обычно указывают буферы чтения, которые являются несколькими из максимального размера пакета канала. (Драйверы получают максимальный размер пакета USB-канала в структуре WDF_USB_PIPE_INFORMATION.) По умолчанию платформа сообщает об ошибке, если драйвер задает буфер чтения, который не является максимальным размером пакета канала. Если драйвер вызывает WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, платформа не сообщает об ошибке, если буфер чтения не имеет максимального размера пакета.

Дополнительные сведения о методе WdfUsbTargetPipeSetNoMaximumPacketSizeCheck и целевых объектов usb-ввода-вывода см. в целевых объектов USB-ввода-вывода.

Примеры

В следующем примере кода отключается проверка платформы на то, является ли размер буфера нескольким из максимального размера пакета USB-канала.

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
 

Требования

Требование Ценность
целевая платформа Всеобщий
минимальная версия KMDF 1.0
минимальная версия UMDF 2.0
заголовка wdfusb.h (include Wdfusb.h)
библиотеки Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
правил соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

См. также

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe