Función VideoPortSetRegistryParameters (video.h)

La función VideoPortSetRegistryParameters escribe información en la clave del adaptador 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 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.

Comentarios

VideoPortSetRegistryParameters busca en la clave de adaptador del Registro el nombre de valor especificado en el parámetro ValueName . 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.

En el caso de Windows XP y versiones posteriores del sistema operativo, el nombre de valor especificado en los parámetros ValueName no necesita asociarse directamente con la clave del adaptador . En su lugar, ValueName se puede asociar a una subclave cuya ruta de acceso incluya la clave del adaptador . Si la cadena ValueName 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 del Registro, creando SubKey1 si no existe. A continuación, la función busca el nombre del valor Value1 , 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 del adaptador , pero el comportamiento de esta función es esencialmente el mismo. Si en cualquier 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 por "DefaultSettings". (tenga en cuenta que el punto forma parte de la cadena). En los sistemas operativos anteriores a Windows 2000, un controlador de minipuerto 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 por "DefaultSettings". Provoca un error de aserción.

No se puede llamar a VideoPortSetRegistryParameters desde las funciones HwVidInterrupt o HwVidTimer de un controlador de minipuerto, desde VideoPortQueueDpc o desde una devolución de llamada a VideoPortSynchronizeExecution.

Requisitos

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

Vea también

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters