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 l’un des éléments suivants :
NDIS_STATUS_SUCCESS
La valeur fournie à ParameterValue a été écrite dans le Registre. S’il s’agit d’une nouvelle entrée, le nom à 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
Impossible d’écrire les informations demandées.
[in] ConfigurationHandle
Handle vers une clé de Registre retournée par le 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 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 en tant que type UNICODE_STRING.
[in] ParameterValue
Pointeur vers un appelant fourni structure NDIS_CONFIGURATION_PARAMETER.
Valeur de retour
Aucun
Remarques
Si une entrée du même nom qu’à 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 de mot clé NDIS est un synonyme d’un nom d’entrée de valeur . Ce nom est une séquence comptée de caractères Unicode, terminée par un caractère Null.
NdisWriteConfiguration tampons et copie la chaîne fournie par l’appelant à mot clé et les données fournies par l’appelant spécifiées à ParameterValue. Cette mémoire est libérée lorsque le pilote libère le ConfigurationHandle avec la fonction NdisCloseConfiguration. L’appelant de NdisWriteConfiguration est chargé de libérer la chaîne mise en mémoire tampon à mot clé et la mémoire allouée pour le structure NDIS_CONFIGURATION_PARAMETER.
En guise d’alternative à l’appel de NdisWriteConfiguration, chaque pilote NDIS peut configurer des 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 pour Windows 2000 et versions ultérieures, consultez Vue d’ensemble de l’installation de l’appareil.