Función VideoPortEnumerateChildren (video.h)

  • Artículo

La función VideoPortEnumerateChildren permite a un controlador de miniportar de vídeo forzar una reenumeración de sus dispositivos secundarios.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

[in] Reserved

Debe establecerse en NULL.

Valor devuelto

VideoPortEnumerateChildren devuelve NO_ERROR.

Comentarios

Algunos dispositivos generan una interrupción cuando el nuevo hardware está conectado al sistema o cuando el hardware existente está desconectado del sistema. Para estos dispositivos, VideoPortEnumerateChildren puede realizar cambios de sistema tan sin problemas como sea posible. A continuación se muestra un escenario posible que fuerza la reenumeración de dispositivos secundarios a través de VideoPortEnumerateChildren:

  • El nuevo hardware está conectado, lo que genera una interrupción.
  • El controlador de interrupción del controlador de miniporte (HwVidInterrupt) pone en cola una rutina DPC (HwVidDpcRoutine) llamando a VideoPortQueueDpc.
  • El DPC ejecutado de forma asincrónica contiene una llamada a VideoPortEnumerateChildren.
VideoPortEnumerateChildren hace que se llame a HwVidGetVideoChildDescriptor, lo que permite que el administrador de Plug and Play enumere todos los dispositivos secundarios del adaptador.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado video.h (incluya Video.h)
Library Videoprt.lib
Archivo DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

Consulte también

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc