Compartir a través de

Función VideoPortEnumerateChildren (video.h)

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.

Observaciones

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 del sistema lo más fluida 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 al HwVidGetVideoChildDescriptor, lo que permite que el Administrador de Plug and Play enumere todos los dispositivos secundarios del adaptador.

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
de la plataforma de destino de Escritorio
encabezado de video.h (incluya Video.h)
biblioteca de Videoprt.lib
DLL de Videoprt.sys
irQL <= DISPATCH_LEVEL

Consulte también

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc