Funzione VideoPortSetRegistryParameters (video.h)

La funzione VideoPortSetRegistryParameters scrive informazioni nella chiave dell'adattatore nel Registro di sistema.

Sintassi

VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
       PVOID HwDeviceExtension,
  [in] PWSTR ValueName,
  [in] PVOID ValueData,
       ULONG ValueLength
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] ValueName

Puntatore a un buffer contenente una stringa Unicode con terminazione Null che assegna un nome alla voce di valore per cui i dati vengono scritti nel Registro di sistema.

[in] ValueData

Puntatore a un buffer contenente i valori da scrivere per la voce ValueName .

ValueLength

Specifica le dimensioni, in byte, dei dati da scrivere nel Registro di sistema.

Valore restituito

VideoPortSetRegistryParameters restituisce NO_ERROR se i dati specificati sono stati scritti correttamente nel Registro di sistema. In caso contrario, può restituire ERROR_INVALID_PARAMETER.

Commenti

VideoPortSetRegistryParameters cerca nella chiave dell'adattatore del Registro di sistema il nome del valore specificato nel parametro ValueName . Se il nome del valore cercato non esiste, questa funzione lo crea automaticamente. Quando viene trovato o creato il nome del valore, il contenuto del parametro ValueData viene copiato nel nome del valore.

Per windows XP e versioni successive del sistema operativo, il nome del valore specificato nei parametri ValueName non deve essere associato direttamente alla chiave dell'adattatore . È invece possibile associare ValueName a una sottochiave il cui percorso include la chiave dell'adattatore . Se la stringa ValueName contiene una o più barre rovesciata, VideoPortSetRegistryParameters cerca o crea la sottochiave il cui nome valore si trova alla fine della stringa.

Ad esempio, se ValueName è impostato sulla stringa "SubKey1\Value1", questa funzione cerca SubKey1 nella chiave dell'adattatore nel Registro di sistema, creando SubKey1 se non esiste. La funzione cerca quindi il nome del valore Value1 , creandolo, se necessario. VideoPortSetRegistryParameters copia quindi il contenuto del parametro ValueData nel Registro di sistema. Il percorso specificato nel parametro ValueName può fare riferimento a un nome di valore con un numero arbitrario di livelli sotto la chiave dell'adattatore , ma il comportamento di questa funzione è essenzialmente lo stesso. Se in qualsiasi momento non viene trovato un nome di sottochiave o valore, viene creato automaticamente.

In Windows 2000 e versioni successive VideoPortSetRegistryParameters restituisce ERROR_INVALID_PARAMETER se la stringa passata nel parametro ValueName inizia con "DefaultSettings". Si noti che il punto fa parte della stringa. Nei sistemi operativi precedenti a Windows 2000, un driver miniport video può passare un nome di valore che inizia con "DefaultSettings". per specificare la risoluzione predefinita per un monitor, ma non è necessario tale funzionalità in Windows 2000 e versioni successive.

In una build controllata di qualsiasi versione del sistema operativo, un nome di valore che inizia con "DefaultSettings". causa un errore di asserzione.

VideoPortSetRegistryParameters non può essere chiamato dalle funzioni HwVidInterrupt o HwVidTimer di un driver miniport o da VideoPortQueueDpc o da un callback a VideoPortSynchronizeExecution.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedi anche

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters