Fonction VideoPortSetRegistryParameters (video.h)

  • Article

La fonction VideoPortSetRegistryParameters écrit des informations sous la clé de l’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 de périphérique 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 ont été correctement écrites 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 valeur recherché n’existe pas, cette fonction le 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 Windows XP et les versions ultérieures du système d’exploitation, le nom de valeur spécifié dans les paramètres ValueName n’a pas besoin d’être directement associé à la clé de l’adaptateur . Au lieu de cela, ValueName peut être associé à une sous-clé dont le chemin d’accès inclut la clé de l’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 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, créant SubKey1 si elle n’existe pas. La fonction recherche ensuite le nom de la 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 sous la clé de l’adaptateur , mais le comportement de cette fonction est essentiellement le même. Si à un moment donné, une sous-clé ou un nom de valeur est introuvable, elle est créée 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 le point fait partie de la chaîne). Dans les systèmes d’exploitation antérieurs à Windows 2000, un pilote de miniport vidéo peut transmettre un nom de valeur commençant par « DefaultSettings » pour spécifier la résolution par défaut d’un moniteur, mais cette fonctionnalité n’est pas nécessaire 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 commençant par « DefaultSettings » provoque un échec d’assertion.

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

Configuration requise

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

Voir aussi

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters