Função VideoPortSetRegistryParameters (video.h)

A função VideoPortSetRegistryParameters grava informações na chave do adaptador no registro.

Sintaxe

VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
       PVOID HwDeviceExtension,
  [in] PWSTR ValueName,
  [in] PVOID ValueData,
       ULONG ValueLength
);

Parâmetros

HwDeviceExtension

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

[in] ValueName

Ponteiro para um buffer que contém uma cadeia de caracteres Unicode terminada em nulo que nomeia a entrada de valor para a qual os dados estão sendo gravados no registro.

[in] ValueData

Ponteiro para um buffer que contém os valores a serem gravados para a entrada ValueName .

ValueLength

Especifica o tamanho, em bytes, dos dados a serem gravados no registro.

Valor retornado

VideoPortSetRegistryParameters retornará NO_ERROR se os dados determinados tiverem sido gravados com êxito no registro. Caso contrário, ele pode retornar ERROR_INVALID_PARAMETER.

Comentários

VideoPortSetRegistryParameters pesquisa na chave do adaptador do registro o nome do valor especificado no parâmetro ValueName . Se o nome do valor pesquisado não existir, essa função o criará automaticamente. Quando o nome do valor é encontrado ou criado, o conteúdo do parâmetro ValueData é copiado para o nome do valor.

Para o Windows XP e versões posteriores do sistema operacional, o nome do valor especificado nos parâmetros ValueName não precisa ser associado diretamente à chave do adaptador . Em vez disso, ValueName pode ser associado a uma subchave cujo caminho inclui a chave do adaptador . Se a cadeia de caracteres ValueName contiver uma ou mais barras invertidas, VideoPortSetRegistryParameters procurará ou criará a subchave cujo nome de valor está no final da cadeia de caracteres.

Por exemplo, se ValueName estiver definido como a cadeia de caracteres "SubKey1\Value1", essa função procurará SubKey1 na chave do adaptador no registro, criando SubKey1 se ela não existir. Em seguida, a função pesquisa o nome do valor Value1 , criando-o, se necessário. VideoPortSetRegistryParameters copia o conteúdo do parâmetro ValueData para o registro. O caminho especificado no parâmetro ValueName pode fazer referência a um nome de valor um número arbitrário de níveis abaixo da chave do adaptador , mas o comportamento dessa função é essencialmente o mesmo. Se em algum momento um nome de subchave ou valor não for encontrado, ele será criado automaticamente.

No Windows 2000 e posterior, VideoPortSetRegistryParameters retornará ERROR_INVALID_PARAMETER se a cadeia de caracteres passada no parâmetro ValueName começar com "DefaultSettings". (observe que o período faz parte da cadeia de caracteres). Em sistemas operacionais anteriores ao Windows 2000, um driver de miniporto de vídeo pode passar um nome de valor que começa com "DefaultSettings" para especificar a resolução padrão de um monitor, mas não há necessidade desse recurso no Windows 2000 e posterior.

Em um build verificado de qualquer versão do sistema operacional, um nome de valor que começa com "DefaultSettings" causa uma falha de asserção.

VideoPortSetRegistryParameters 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.

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

VideoPortFlushRegistry

VideoPortGetRegistryParameters