Função VideoPortEnumerateChildren (video.h)

  • Artigo

A função VideoPortEnumerateChildren permite que um driver de miniporto de vídeo force uma reenumeração de seus dispositivos filho.

Sintaxe

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

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão de dispositivo do driver de miniport.

[in] Reserved

Deve ser definido como NULL.

Retornar valor

VideoPortEnumerateChildren retorna NO_ERROR.

Comentários

Alguns dispositivos geram uma interrupção quando um novo hardware está conectado ao sistema ou quando o hardware existente é desconectado do sistema. Para esses dispositivos, VideoPortEnumerateChildren pode fazer essas alterações no sistema o mais simples possível. Este é um cenário possível que força a reenumeração de dispositivos filho por meio de VideoPortEnumerateChildren:

  • O novo hardware está conectado, o que gera uma interrupção.
  • O manipulador de interrupção do driver de miniport (HwVidInterrupt) enfileira uma rotina DPC (HwVidDpcRoutine) chamando VideoPortQueueDpc.
  • O DPC executado de forma assíncrona contém uma chamada para VideoPortEnumerateChildren.
VideoPortEnumerateChildren faz com que HwVidGetVideoChildDescriptor seja chamado, permitindo que o Gerenciador de Plug and Play enumere todos os dispositivos filho do adaptador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho video.h (incluir Video.h)
Biblioteca Videoprt.lib
DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

Confira também

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc