Função VideoPortGetRegistryParameters (video.h)

A função VideoPortGetRegistryParameters recupera informações de configuração específicas do dispositivo na 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 miniporto.

[in] ParameterName

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

IsParameterFileName

Se o valor for TRUE, o valor de dados retornado normalmente será tratado como um nome de arquivo. Nesse caso, o conteúdo 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 de VIDEO_PORT_CONFIG_INFO .

Valor retornado

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, retorna ERROR_INVALID_PARAMETER.

Comentários

VideoPortGetRegistryParameters não pode ser chamado de 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 do número de valor1 na subchave SubKey1.

A chave do Registro da qual VideoPortGetRegistryParameters recupera informações de configuração não pode conter informações 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 miniporto 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

   
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Desktop
Cabeçalho video.h (inclua Video.h)
Biblioteca Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Confira também

HwVidFindAdapter

HwVidInitialize

HwVidQueryDeviceCallback

HwVidQueryNamedValueCallback

VIDEO_PORT_CONFIG_INFO

VideoPortFlushRegistry

VideoPortGetDeviceData

VideoPortSetRegistryParameters