PMINIPORT_GET_REGISTRY_ROUTINE função de retorno de chamada (video.h)

Artigo
03/01/2024

HwVidQueryNamedValueCallback processa os dados especificados recuperados do registro.

Sintaxe

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

Parâmetros

HwDeviceExtension

Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte Extensões de dispositivo.

Context

Ponteiro para um contexto determinado pelo driver especificado como entrada para a função VideoPortGetRegistryParameters .

ValueName

Ponteiro para uma cadeia de caracteres Unicode terminada em NULL nomeando a entrada.

ValueData

Ponteiro para os dados armazenados em buffer associados a ValueName, fornecidos por VideoPortGetRegistryParameters.

ValueLength

Especifica o tamanho em bytes do buffer em ValueData.

Retornar valor

HwVidQueryNamedValueCallback retorna o status da operação.

Comentários

HwVidQueryNamedValueCallback é uma função de driver de miniporto opcional passada em uma chamada para VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters chama HwVidQueryNamedValueCallback depois de coletar informações de configuração disponíveis sobre o ValueName fornecido na chave do adaptador do Registro.

HwVidFindAdapter ou HwVidInitialize pode chamar VideoPortGetRegistryParameters com uma função HwVidQueryNamedValueCallback fornecida pelo driver, ponteiros para a extensão do dispositivo e quaisquer dados de contexto fornecidos pelo driver (que podem ser o buffer VIDEO_PORT_CONFIG_INFO ) e um ponteiro para uma cadeia de caracteres Unicode nomeando o valor a ser recuperado do registro.

HwVidFindAdapter ou HwVidInitialize pode definir o argumento IsFileNameParameter de VideoPortGetRegistryParameters como TRUE se a cadeia de caracteres Unicode fornecida pelo driver for uma entrada de registro nomeada cujo valor é um nome de arquivo. Para essa especificação, os dados retornados serão o conteúdo do arquivo nomeado.

Quando VideoPortGetRegistryParameters chama a função HwVidQueryNamedValueCallback , ela processa todos os dados de configuração disponibilizados. Por exemplo, HwVidQueryNamedValueCallback pode usar dados recuperados para determinar os intervalos de acesso do driver de miniport e configurar seus intervalos de acesso do emulador (se houver), interromper o vetor ou interromper o IRQL (se houver) e assim por diante no buffer VIDEO_PORT_CONFIG_INFO, bem como na extensão de dispositivo do driver de miniporto, antes de retornar o controle para a função HwVidFindAdapter .

HwVidInitialize também pode chamar VideoPortGetRegistryParameters com IsFileNameParameter definido como TRUE para que a função HwVidQueryNamedValueCallback fornecida pelo miniport driver possa usar o conteúdo em buffer de um arquivo nomeado para configurar o microcódigo no adaptador.

O ValueData retornado está na pilha, portanto, ele pode ser referenciado localmente. HwVidQueryNamedValueCallback pode armazenar algumas ou todas as informações retornadas para uso por outras funções de driver de miniport no HwDeviceExtension de entrada ou usar o Contexto de entrada como um ponteiro para um local onde os dados podem ser armazenados.

HwVidQueryNamedValueCallback deve ser tornado paginável.