PMINIPORT_GET_REGISTRY_ROUTINE función de devolución de llamada (video.h)

Artículo
08/07/2023

HwVidQueryNamedValueCallback procesa los datos especificados recuperados del registro.

Sintaxis

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

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

Parámetros

HwDeviceExtension

Puntero al área de almacenamiento por adaptador del controlador de miniporte. Para obtener más información, consulte Extensiones de dispositivo.

Context

Puntero a un contexto determinado por el controlador especificado como entrada para la función VideoPortGetRegistryParameters .

ValueName

Puntero a una cadena Unicode terminada en NULL que asigna un nombre a la entrada.

ValueData

Puntero a los datos almacenados en búfer asociados a ValueName, proporcionados por VideoPortGetRegistryParameters.

ValueLength

Especifica el tamaño en bytes del búfer en ValueData.

Valor devuelto

HwVidQueryNamedValueCallback devuelve el estado de la operación.

Comentarios

HwVidQueryNamedValueCallback es una función de controlador de miniport opcional que se pasa en una llamada a VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters llama a HwVidQueryNamedValueCallback después de recopilar información de configuración disponible sobre valueName determinado en la clave de adaptador del registro.

HwVidFindAdapter o HwVidInitialize pueden llamar a VideoPortGetRegistryParameters con una función HwVidQueryNamedValueCallback proporcionada por el controlador, punteros a la extensión del dispositivo y a cualquier dato de contexto proporcionado por el controlador (que puede ser el búfer de VIDEO_PORT_CONFIG_INFO ) y un puntero a una cadena Unicode que asigna el nombre al valor que se va a recuperar del registro.

HwVidFindAdapter o HwVidInitialize pueden establecer el argumento IsFileNameParameters de VideoPortGetRegistryParameter en TRUE si la cadena Unicode proporcionada por el controlador es una entrada del Registro con nombre cuyo valor es un nombre de archivo. Para esta especificación, los datos devueltos serán el contenido del archivo con nombre.

Cuando VideoPortGetRegistryParameters llama a la función HwVidQueryNamedValueCallback , procesa los datos de configuración que estén disponibles. Por ejemplo, HwVidQueryNamedValueCallback podría usar datos recuperados para determinar los intervalos de acceso del controlador de miniporte y configurar sus intervalos de acceso del emulador (si existe), el vector de interrupción o la interrupción IRQL (si existe), etc. en el búfer de VIDEO_PORT_CONFIG_INFO, así como en la extensión del dispositivo del controlador de miniporte, antes de devolver el control a la función HwVidFindAdapter .

HwVidInitialize también puede llamar a VideoPortGetRegistryParameters con IsFileNameParameter establecido en TRUE para que la función HwVidQueryNamedValueCallback proporcionada por el controlador miniporte pueda usar el contenido almacenado en búfer de un archivo con nombre para configurar el microcódigo en el adaptador.

ValueData devuelto está en la pila, por lo que se puede hacer referencia localmente. HwVidQueryNamedValueCallback puede almacenar parte o toda la información devuelta para su uso por otras funciones del controlador de miniporte en la entrada HwDeviceExtension o usar el contexto de entrada como puntero a una ubicación donde se pueden almacenar los datos.

HwVidQueryNamedValueCallback debe ser paginable.