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
| 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 |