NdisWriteConfiguration, fonction (ndis.h)
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 l’état 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 caractère null.
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) |