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 do 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 de retorno
VideoPortSetRegistryParameters retornará NO_ERROR se os dados determinados tiverem sido gravados com êxito no registro. Caso contrário, ele poderá retornar ERROR_INVALID_PARAMETER.
Observações
VideoPortSetRegistryParameters pesquisa na chave do adaptador do registro para 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 diretamente associado ao adaptador chave. 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 for definido como a cadeia de caracteres "SubKey1\Value1", essa função procurará SubKey1 na chave do adaptador no registro, criando SubKey1 se ele 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 do adaptador chave, 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 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 podem ser chamados de HwVidInterrupt ou funções de HwVidTimer ou de VideoPortQueueDpc, ou de um retorno de chamada para VideoPortSynchronizeExecution.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |
| biblioteca | Videoprt.lib |
| de DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |