Fonction NetAdapterOpenConfiguration (netadapter.h)

  • Article

La fonction NetAdapterOpenConfiguration ouvre la base de données de configuration d’un adaptateur net.

Syntaxe

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Paramètres

[_In_] Adapter

Objet de carte réseau créé par le client lors d’un appel précédent à NetAdapterCreate.

[_In_opt_] ConfigurationAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES qui contient des attributs fournis par le pilote pour le nouvel objet de configuration. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Configuration

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de configuration de l’adaptateur.

Valeur retournée

La fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.

Remarques

En règle générale, le client appelle cette fonction à partir de sa fonction de rappel EVT_WDF_DRIVER_DEVICE_ADD .

Si le client fournit une WDF_OBJECT_ATTRIBUTES, il spécifie NULL pour ParentObject. L’objet de configuration de l’adaptateur est automatiquement parenté avec l’objet adaptateur.

Par conséquent, WDF supprime automatiquement l’objet de configuration lorsque l’adaptateur est supprimé. Toutefois, le client peut supprimer manuellement un objet de configuration en appelant WdfObjectDelete, généralement à partir de sa fonction de rappel EVT_WDF_OBJECT_CONTEXT_CLEANUP .

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.21
En-tête netadapter.h (inclure netadaptercx.h)
Bibliothèque NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

Voir aussi

Accès aux informations de configuration

NetConfigurationClose