Função VideoPortGetRegistryParameters (video.h)

Artigo
03/01/2024

A função VideoPortGetRegistryParameters recupera informações de configuração específicas do dispositivo sob a chave do adaptador no Registro na inicialização.

Sintaxe

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Parâmetros

HwDeviceExtension

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

[in] ParameterName

Ponteiro para uma cadeia de caracteres Unicode terminada em NULL que nomeia a entrada de valor a ser recuperada do registro. Confira a seção Comentários para obter mais informações.

IsParameterFileName

Se o valor for TRUE, o valor de dados normalmente retornado será tratado como um nome de arquivo. Nesse caso, o conteúdo armazenado em buffer desse arquivo é retornado, em vez do próprio parâmetro.

GetRegistryRoutine

Ponteiro para a função HwVidQueryNamedValueCallback do driver de miniport.

Context

Ponteiro para um parâmetro de contexto determinado pelo chamador a ser passado para o CallbackRoutine, normalmente o buffer VIDEO_PORT_CONFIG_INFO .

Retornar valor

VideoPortGetRegistryParameters retorna NO_ERROR se ele coletou com êxito as informações solicitadas e chamou a função HwVidQueryNamedValueCallback do driver de miniport; caso contrário, retornará ERROR_INVALID_PARAMETER.

Comentários

VideoPortGetRegistryParameters não pode ser chamado das funções HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc ou de um retorno de chamada para VideoPortSynchronizeExecution.

Para o Windows XP e versões posteriores do sistema operacional, o parâmetro ParameterName pode conter um caminho que faz referência exatamente a um nome de valor um ou mais níveis abaixo da chave do adaptador . Por exemplo, a cadeia de caracteres "SubKey1\Value1" pode ser usada para obter a entrada de valor para o número de valor Value1 na subchave SubKey1.

A chave do Registro da qual VideoPortGetRegistryParameters recupera informações de configuração não pode conter nenhuma informação sobre o driver de exibição correspondente, pois as funções HwVidFindAdapter do driver de miniporto são executadas antes de qualquer driver de exibição ser carregado.

Os drivers de miniport não devem consultar as informações de configuração armazenadas nas entradas DefaultSettings , que podem não ter suporte em versões posteriores do sistema operacional.

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 (inclua Video.h)
Biblioteca	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL