Función VideoPortGetRegistryParameters (video.h)

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

Consulte también

HwVidFindAdapter

HwVidInitialize

HwVidQueryDeviceCallback

HwVidQueryNamedValueCallback

VIDEO_PORT_CONFIG_INFO

VideoPortFlushRegistry

VideoPortGetDeviceData

VideoPortSetRegistryParameters