Функция WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)
[Относится к KMDF и UMDF]
Метод WdfUsbTargetPipeSetNoMaximumPacketSizeCheck отключает проверку платформы на то, является ли размер буфера чтения драйвера кратным максимальному размеру пакета USB-канала.
Синтаксис
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Параметры
[in] Pipe
Дескриптор объекта канала платформы, полученный путем вызова WdfUsbInterfaceGetConfiguredPipe.
Возвращаемое значение
None
Remarks
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Чтобы избежать получения дополнительных данных от непредвиденных действий шины, которые иногда называют лепетом, драйверы обычно указывают буферы чтения, которые кратны максимальному размеру пакета канала. (Драйверы получают максимальный размер пакета USB-канала в структуре WDF_USB_PIPE_INFORMATION .) По умолчанию платформа сообщает об ошибке, если драйвер указывает буфер чтения, который не кратен максимальному размеру пакета канала. Если драйвер вызывает WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, платформа не сообщает об ошибке, если буфер чтения не кратен максимальному размеру пакета.
Дополнительные сведения о методе WdfUsbTargetPipeSetNoMaximumPacketSizeCheck и целевых объектах ввода-вывода USB см. в разделе Целевые объекты ввода-вывода USB.
Примеры
В следующем примере кода отключается проверка платформы на то, является ли размер буфера кратным максимальному размеру пакета USB-канала.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Минимальная версия UMDF | 2,0 |
| Верхняя часть | wdfusb.h (включая 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) |