VideoPortGetRegistryParameters, fonction (video.h)

Article
02/27/2024

La fonction VideoPortGetRegistryParameters récupère des informations de configuration spécifiques à l’appareil sous la clé d’adaptateur dans le Registre au démarrage.

Syntaxe

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] ParameterName

Pointeur vers une chaîne Unicode terminée par null qui nomme l’entrée de valeur à récupérer à partir du Registre. Pour plus d’informations, consultez la section Remarques.

IsParameterFileName

Si la valeur est TRUE, la valeur de données normalement retournée est traitée comme un nom de fichier. Dans ce cas, le contenu mis en mémoire tampon de ce fichier est retourné, plutôt que le paramètre lui-même.

GetRegistryRoutine

Pointeur vers la fonction HwVidQueryNamedValueCallback du pilote miniport.

Context

Pointeur vers un paramètre de contexte déterminé par l’appelant à passer à callbackRoutine, généralement la mémoire tampon VIDEO_PORT_CONFIG_INFO .

Valeur retournée

VideoPortGetRegistryParameters retourne NO_ERROR s’il a correctement collecté les informations demandées et appelé la fonction HwVidQueryNamedValueCallback du pilote miniport ; sinon, retourne ERROR_INVALID_PARAMETER.

Remarques

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

Pour Windows XP et les versions ultérieures du système d’exploitation, le paramètre ParameterName peut contenir un chemin d’accès qui référence exactement un nom de valeur à un ou plusieurs niveaux sous la clé de l’adaptateur . Par exemple, la chaîne « SubKey1\Value1 » peut être utilisée pour obtenir l’entrée de valeur pour le numéro de valeur Value1 sous la sous-clé SubKey1.

La clé de Registre à partir de laquelle VideoPortGetRegistryParameters récupère les informations de configuration ne peut pas contenir d’informations sur le pilote d’affichage correspondant, car les fonctions HwVidFindAdapter du pilote miniport s’exécutent avant le chargement d’un pilote d’affichage.

Les pilotes Miniport ne doivent pas interroger les informations de configuration stockées dans les entrées DefaultSettings , qui peuvent ne pas être prises en charge dans les versions ultérieures du système d’exploitation.

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 (incluez Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL