VideoPortSetRegistryParameters, fonction (video.h)

La fonction VideoPortSetRegistryParameters écrit des informations sous la clé d’adaptateur dans le Registre.

Syntaxe

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

Paramètres

HwDeviceExtension

Pointeur vers l’extension d’appareil du pilote miniport.

[in] ValueName

Pointeur vers une mémoire tampon contenant une chaîne Unicode terminée par null qui nomme l’entrée de valeur pour laquelle les données sont écrites dans le Registre.

[in] ValueData

Pointeur vers une mémoire tampon contenant les valeurs à écrire pour l’entrée ValueName .

ValueLength

Spécifie la taille, en octets, des données à écrire dans le Registre.

Valeur retournée

VideoPortSetRegistryParameters retourne NO_ERROR si les données données données ont été écrites avec succès dans le Registre. Sinon, il peut retourner ERROR_INVALID_PARAMETER.

Remarques

VideoPortSetRegistryParameters recherche sous la clé d’adaptateur du Registre le nom de valeur spécifié dans le paramètre ValueName . Si le nom de la valeur recherché n’existe pas, cette fonction la crée automatiquement. Lorsque le nom de la valeur est trouvé ou créé, le contenu du paramètre ValueData est copié dans le nom de la valeur.

Pour les versions du système d’exploitation Windows XP et ultérieures, le nom de la valeur spécifié dans les paramètres ValueName n’a pas besoin d’être directement associé à la clé d’adaptateur . Au lieu de cela, ValueName peut être associé à une sous-clé dont le chemin inclut la clé d’adaptateur . Si la chaîne ValueName contient une ou plusieurs barres obliques inverses, VideoPortSetRegistryParameters recherche ou crée la sous-clé dont le nom de la valeur se trouve à la fin de la chaîne.

Par exemple, si ValueName est défini sur la chaîne « SubKey1\Value1 », cette fonction recherche SubKey1 sous la clé d’adaptateur dans le Registre, en créant SubKey1 s’il n’existe pas. La fonction recherche ensuite le nom de valeur Value1 , en le créant si nécessaire. VideoPortSetRegistryParameters copie ensuite le contenu du paramètre ValueData dans le registre. Le chemin spécifié dans le paramètre ValueName peut faire référence à un nom de valeur un nombre arbitraire de niveaux inférieur à la clé d’adaptateur , mais le comportement de cette fonction est essentiellement le même. Si à un moment donné, un sous-clé ou un nom de valeur n’est pas trouvé, il est créé automatiquement.

Dans Windows 2000 et versions ultérieures, VideoPortSetRegistryParameters retourne ERROR_INVALID_PARAMETER si la chaîne transmise dans le paramètre ValueName commence par « DefaultSettings ». (notez que la période fait partie de la chaîne). Dans les systèmes d’exploitation antérieurs à Windows 2000, un pilote vidéo miniport peut passer un nom de valeur qui commence par « DefaultSettings ». pour spécifier la résolution par défaut d’un moniteur, mais il n’est pas nécessaire de cette fonctionnalité dans Windows 2000 et versions ultérieures.

Dans une build vérifiée de n’importe quelle version du système d’exploitation, un nom de valeur qui commence par « DefaultSettings ». provoque un échec d’assertion.

VideoPortSetRegistryParameters ne peut pas être appelé à partir de fonctions HwVidInterrupt ou HwVidTimer , ou de VideoPortQueueDpc, ou d’un rappel à VideoPortSynchronizeExecution.

Configuration requise

   
Client minimal pris en charge Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Bureau
En-tête video.h (include Video.h)
Bibliothèque Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Voir aussi

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters