Función VideoPortGetRegistryParameters (video.h)

Artículo
03/05/2024

La función VideoPortGetRegistryParameters recupera información de configuración específica del dispositivo en la clave del adaptador en el registro durante el inicio.

Sintaxis

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Parámetros

HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

[in] ParameterName

Puntero a una cadena Unicode terminada en NULL que asigna un nombre a la entrada de valor que se va a recuperar del Registro. Para obtener más información, consulta la sección Comentarios.

IsParameterFileName

Si el valor es TRUE, el valor de datos que se devuelve normalmente se trata como un nombre de archivo. En ese caso, se devuelve el contenido almacenado en búfer de ese archivo, en lugar del propio parámetro.

GetRegistryRoutine

Puntero a la función HwVidQueryNamedValueCallback del controlador de miniporte.

Context

Puntero a un parámetro de contexto determinado por el autor de la llamada que se va a pasar a CallbackRoutine, normalmente el búfer de VIDEO_PORT_CONFIG_INFO .

Valor devuelto

VideoPortGetRegistryParameters devuelve NO_ERROR si recopiló correctamente la información solicitada y llamó a la función HwVidQueryNamedValueCallback del controlador de miniporte; de lo contrario, devuelve ERROR_INVALID_PARAMETER.

Comentarios

No se puede llamar a VideoPortGetRegistryParameters desde las funciones HwVidInterrupt o HwVidTimer del controlador de miniportador, o desde VideoPortQueueDpc, o desde una devolución de llamada a VideoPortSynchronizeExecution.

Para Windows XP y versiones posteriores del sistema operativo, el parámetro ParameterName puede contener una ruta de acceso que haga referencia exactamente a un nombre de valor uno o varios niveles por debajo de la clave del adaptador . Por ejemplo, la cadena "SubKey1\Value1" se puede usar para obtener la entrada de valor del número de valor Value1 en la subclave SubKey1.

La clave del Registro de la que VideoPortGetRegistryParameters recupera información de configuración no puede contener ninguna información sobre el controlador de pantalla correspondiente, ya que las funciones HwVidFindAdapter del controlador de miniporte se ejecutan antes de cargar cualquier controlador de pantalla.

Los controladores miniport no deben consultar la información de configuración almacenada en las entradas DefaultSettings , que puede que no se admita en versiones posteriores del sistema operativo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	video.h (incluya Video.h)
Library	Videoprt.lib
Archivo DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL