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.

Retornar valor

VideoPortSetRegistryParameters retornará NO_ERROR se os dados determinados tiverem sido gravados com êxito no registro. Caso contrário, ele poderá 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 pesquisa ou cria a subchave cujo nome de valor está no final da cadeia de caracteres.

Por exemplo, se ValueName for 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 se referir 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 miniporta de vídeo pode passar um nome de valor que começa com "DefaultSettings". para especificar a resolução padrão para 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 das funções HwVidInterrupt ou HwVidTimer de um driver de miniport, ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution.

Requisitos

Confira também

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters