NdisWriteConfiguration, fonction (ndis.h)

Article
08/07/2023

La fonction NdisWriteConfiguration écrit une valeur fournie par l’appelant pour une entrée spécifiée dans le Registre. Cette fonction doit être appelée en série par rapport à elle-même et à la fonction NdisReadConfiguration .

Syntaxe

void NdisWriteConfiguration(
  [out] PNDIS_STATUS                  Status,
  [in]  NDIS_HANDLE                   ConfigurationHandle,
  [in]  PNDIS_STRING                  Keyword,
  [in]  PNDIS_CONFIGURATION_PARAMETER ParameterValue
);

Paramètres

[out] Status

Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le status de l’appel comme suit :

NDIS_STATUS_SUCCESS

La valeur fournie dans ParameterValue a été écrite dans le Registre. S’il s’agit d’une nouvelle entrée, le nom dans Mot clé a également été écrit dans le Registre.

NDIS_STATUS_NOT_SUPPORTED

Le ParameterType fourni n’est pas valide.

NDIS_STATUS_RESOURCES

NDIS n’a pas pu allouer de ressources, généralement suffisamment de mémoire, pour transférer les informations demandées au Registre.

NDIS_STATUS_FAILURE

Les informations demandées n’ont pas pu être écrites.

[in] ConfigurationHandle

Handle d’une clé de Registre qui a été retournée par NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, ou Fonction NdisOpenConfigurationKeyByName .

[in] Keyword

Pointeur vers un type NDIS_STRING décrivant une chaîne comptée fournie par l’appelant, dans le jeu de caractères par défaut du système, en spécifiant le nom d’une entrée pour laquelle écrire la valeur. Pour les pilotes Microsoft Windows 2000 et versions ultérieures, cette chaîne contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

[in] ParameterValue

Pointeur vers un appelant fourni NDIS_CONFIGURATION_PARAMETER structure.

Valeur de retour

None

Remarques

Si une entrée du même nom que dans Mot clé existe déjà sous la clé de Registre ouverte, NdisWriteConfiguration remplace sa valeur actuelle par la valeur fournie par l’appelant. Sinon, NdisWriteConfiguration ajoute une nouvelle entrée de valeur avec le nom donné et la valeur fournie au Registre.

Dans le registre de configuration de Windows 2000 et versions ultérieures, un mot clé NDIS est un synonyme d’un nom d’entrée de valeur. Un tel nom est une séquence comptée de caractères Unicode, terminée par un NUL.

NdisWriteConfiguration met en mémoire tampon et copie la chaîne fournie par l’appelant dans Mot clé et les données fournies par l’appelant spécifiées dans ParameterValue . Cette mémoire est libérée lorsque le pilote libère la ConfigurationHandle avec la fonction NdisCloseConfiguration . L’appelant de NdisWriteConfiguration est responsable de la libération de la chaîne mise en mémoire tampon au niveau du mot clé et de la mémoire allouée pour le NDIS_CONFIGURATION_PARAMETER structure.

En guise d’alternative à l’appel de NdisWriteConfiguration, chaque pilote NDIS peut configurer les informations de configuration dans le Registre pour lui-même à l’aide de la directive AddReg dans le fichier INF du pilote.

Pour plus d’informations sur les fichiers d’installation et d’installation de Windows 2000 et versions ultérieures, consultez Vue d’ensemble de l’installation des appareils.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisWriteConfiguration (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisWriteConfiguration (NDIS 5.1)) dans Windows XP.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)