Función VideoPortSetRegistryParameters (video.h)
La función VideoPortSetRegistryParameters escribe información en la clave del adaptador de del Registro.
Sintaxis
VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
PVOID HwDeviceExtension,
[in] PWSTR ValueName,
[in] PVOID ValueData,
ULONG ValueLength
);
Parámetros
HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] ValueName
Puntero a un búfer que contiene una cadena Unicode terminada en null que asigna un nombre a la entrada de valor para la que se escriben los datos en el Registro.
[in] ValueData
Puntero a un búfer que contiene los valores que se van a escribir para la entrada de ValueName.
ValueLength
Especifica el tamaño, en bytes, de los datos que se van a escribir en el Registro.
Valor devuelto
videoPortSetRegistryParameters devuelve NO_ERROR si los datos especificados se escribieron correctamente en el registro. De lo contrario, puede devolver ERROR_INVALID_PARAMETER.
Observaciones
VideoPortSetRegistryParameters busca en la clave del adaptador de del Registro el nombre de valor especificado en el parámetro valueName de. Si el nombre del valor que se busca no existe, esta función la crea automáticamente. Cuando se encuentra o crea el nombre del valor, el contenido del parámetro ValueData se copia en el nombre del valor.
Para Windows XP y versiones posteriores del sistema operativo, el nombre de valor especificado en los parámetros de ValueName no es necesario asociar directamente con la clave del adaptador de . En su lugar, ValueName se puede asociar a una subclave cuya ruta de acceso incluye la clave del adaptador de. Si el ValueName cadena contiene una o varias barras diagonales inversas, VideoPortSetRegistryParameters busca o crea la subclave cuyo nombre de valor está al final de la cadena.
Por ejemplo, si valueName se establece en la cadena "SubKey1\Value1", esta función busca SubKey1 en la clave del adaptador de del Registro, creando SubKey1 si no existe. A continuación, la función busca el Value1 nombre de valor, lo que lo crea si es necesario. videoPortSetRegistryParameters copia el contenido del parámetro ValueData en el registro. La ruta de acceso especificada en el parámetro ValueName puede hacer referencia a un nombre de valor un número arbitrario de niveles por debajo de la clave de adaptador de, pero el comportamiento de esta función es esencialmente el mismo. Si en algún momento no se encuentra un nombre de subclave o valor, se crea automáticamente.
En Windows 2000 y versiones posteriores, VideoPortSetRegistryParameters devuelve ERROR_INVALID_PARAMETER si la cadena pasada en el parámetro ValueName comienza con "DefaultSettings". (tenga en cuenta que el punto forma parte de la cadena). En los sistemas operativos anteriores a Windows 2000, un controlador de miniporte de vídeo puede pasar un nombre de valor que comience por "DefaultSettings" para especificar la resolución predeterminada de un monitor, pero no es necesario esa funcionalidad en Windows 2000 y versiones posteriores.
En una compilación comprobada de cualquier versión del sistema operativo, un nombre de valor que comienza con "DefaultSettings". Provoca un error de aserción.
de VideoPortSetRegistryParameters no se puede llamar desde una HwVidInterrupt o funciones de HwVidTimer o desde VideoPortQueueDpc, o desde una devolución de llamada a VideoPortSynchronizeExecution.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | video.h (incluya Video.h) |
| biblioteca de | Videoprt.lib |
| DLL de | Videoprt.sys |
| irQL | PASSIVE_LEVEL |