Função VideoPortGetRegistryParameters (video.h)
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 |