Função VideoPortInitialize (video.h)

Artigo
03/05/2024

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

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 chamou DriverEntry do Driver de Miniporto de Vídeo.

Argument2

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

HwInitializationData

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

HwContext

Deve ser NULL.

Retornar valor

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

Comentários

Cada driver de miniporta 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 driver de miniport.

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 para e inicializa zero a extensão de dispositivo do objeto do dispositivo. Uma extensão de dispositivo é a principal e única área de armazenamento global de cada driver de miniporta para informações de estado específicas do adaptador. O driver de miniporto especifica o tamanho da extensão do dispositivo no membro HwDeviceExtensionSize do VIDEO_HW_INITIALIZATION_DATA. O driver de porta de vídeo passa essa extensão de dispositivo para a maioria das funções de driver de miniporta que ele chama.
Coleta e armazena informações pertinentes na extensão do dispositivo.

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

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	PASSIVE_LEVEL