Функция VideoPortEnumerateChildren (video.h)

Статья
02/07/2025

Функция VideoPortEnumerateChildren позволяет мини-драйверу видеопорта принудительно повторно использовать дочерние устройства.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortEnumerateChildren(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID Reserved
);

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства минипорта драйвера.

[in] Reserved

Необходимо задать значение NULL.

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

VideoPortEnumerateChildren возвращает NO_ERROR.

Замечания

Некоторые устройства создают прерывание при подключении нового оборудования к системе или при отключении существующего оборудования от системы. Для этих устройств VideoPortEnumerateChildren могут вносить такие системные изменения как можно проще. Ниже приведен один из возможных сценариев, который заставляет повторное удаление дочерних устройств через VideoPortEnumerateChildren:

Подключено новое оборудование, которое создает прерывание.
Обработчик прерываний минипорта (HwVidInterrupt) помещает подпрограмму DPC (HwVidDpcRoutine) путем вызова VideoPortQueueDpc.
Асинхронно исполняемый DPC содержит вызов VideoPortEnumerateChildren.

VideoPortEnumerateChildren вызывает вызов HwVidGetVideoChildDescriptor, что позволяет диспетчеру Plug and Play перечислить все дочерние устройства адаптера.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	video.h (include Video.h)
библиотеки	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DISPATCH_LEVEL

См. также

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc

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