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

  • Статья

Функция 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.

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

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

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc