Função VideoPortInitialize (video.h)

Artigo
02/07/2025

A função VideoPortInitialize executa parte da inicialização do driver de miniporto, alocando recursos do sistema para o driver de miniporto.

Sintaxe

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

Parâmetros

Argument1

Um ponteiro com o qual o sistema operacional chamado DriverEntry do Video Miniport Driver.

Argument2

Um segundo ponteiro com o qual o sistema operacional chamado DriverEntry.

HwInitializationData

Ponteiro para a estrutura VIDEO_HW_INITIALIZATION_DATA na pilha. O driver DriverEntry rotina zero inicializou essa estrutura e, em seguida, preencheu-a com informações de configuração específicas do driver descrevendo um adaptador de vídeo que o driver de miniporto pode dar suporte.

HwContext

Deve ser NULL.

Valor de retorno

VideoPortInitialize retorna o status final da operação de inicialização.

Observações

Cada driver de miniporto de vídeo deve chamar VideoPortInitialize de sua função DriverEntry. driverEntry pode chamar VideoPortInitialize somente depois de ter inicializado zero e, em seguida, configurar a estrutura VIDEO_HW_INITIALIZATION_DATA. VideoPortInitialize só pode ser chamado da função DriverEntry de um miniport driver.

A função VideoPortInitialize:

Verifica a validade das especificações de VIDEO_HW_INITIALIZATION_DATA do driver de miniport.
Aloca memória para e inicializa zero uma estrutura de VIDEO_PORT_CONFIG_INFO.
Preenche o máximo de informações de configuração do adaptador possível em VIDEO_PORT_CONFIG_INFO.
Preenche alguns dos membros públicos do objeto de dispositivo criado pelo sistema para representar o adaptador gráfico. O driver de porta de vídeo gerencia os objetos do dispositivo, portanto, o driver de miniporto não precisa se preocupar com os detalhes do objeto do dispositivo.
Aloca memória e inicializa zero a extensão do dispositivo do objeto do dispositivo. Uma extensão de dispositivo é a área de armazenamento principal e global de cada driver de miniporto para informações de estado específicas do adaptador. O driver de miniporto especifica o tamanho da extensão do dispositivo no HwDeviceExtensionSize membro do VIDEO_HW_INITIALIZATION_DATA. O driver da porta de vídeo passa essa extensão de dispositivo para a maioria das funções de driver de miniporto que ele chama.
Coleta e armazena informações pertinentes na extensão do dispositivo.

A rotina DriverEntry do driver do miniporto propaga o valor retornado por VideoPortInitialize de volta para seu chamador. Os drivers de miniporto não devem usar esse valor retornado.

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	PASSIVE_LEVEL

Consulte também

DriverEntry do de Driver de Miniporto de Vídeo

HwVidFindAdapter

HwVidInitialize

VIDEO_HW_INITIALIZATION_DATA

VIDEO_PORT_CONFIG_INFO

VideoPortZeroMemory

Compartilhar via