Функция USBD_RegisterHcFilter (usbdlib.h)

  • Статья

Подпрограмма USBD_RegisterHcFilter устарела в операционных системах Windows XP и более поздних версий. Не используйте.

В операционных системах Windows XP и более поздних версий драйвер фильтра, установленный между корневым концентратором FDO и PDO, видит весь USB-трафик для USB-устройства после его перечисления. Отсутствует поддерживаемый механизм фильтрации запросов дескриптора, возникающих во время перечисления USB-устройства, так как эти запросы возникают и остаются в драйвере порта (usbport.sys), а не в драйвере концентратора.

Синтаксис

void USBD_RegisterHcFilter(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PDEVICE_OBJECT FilterDeviceObject
);

Параметры

[in] DeviceObject

Указатель на объект устройства, который является текущей верхней частью стека, как сообщает IoAttachDeviceToDeviceStack.

[in] FilterDeviceObject

Указатель на объект устройства фильтра, созданный драйвером фильтра для его операций.

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

None

Remarks

Драйверы фильтров шины USB должны вызывать эту подпрограмму после присоединения объекта устройства к стеку объектов устройства для драйвера контроллера узла.

Требования

Требование Значение
Минимальная версия клиента Не рекомендуется.
Целевая платформа Универсальное
Верхняя часть usbdlib.h (включая Usbdlib.h)
Библиотека Usbd.lib
IRQL PASSIVE_LEVEL

См. также раздел

IoAttachDeviceToDeviceStack

Справочник по программированию драйверов USB-устройств