Partilhar via


Função VideoPortEnumerateChildren (video.h)

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 do dispositivo do driver de miniport.

[in] Reserved

Deve ser definido como NULL.

Valor de retorno

VideoPortEnumerateChildren retorna NO_ERROR.

Observações

Alguns dispositivos geram uma interrupção quando o 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 perfeitamente 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 Plug and Play Manager enumere todos os dispositivos filho do adaptador.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Área de trabalho
cabeçalho video.h (inclua Video.h)
biblioteca Videoprt.lib
de DLL Videoprt.sys
IRQL <= DISPATCH_LEVEL

Consulte também

HwVidDpcRoutine

HwVidGetVideoChildDescriptor

HwVidInterrupt

VideoPortQueueDpc