NetAdapterOpenConfiguration, fonction (netadapter.h)
La fonction NetAdapterOpenConfiguration ouvre la base de données de configuration d’une carte réseau.
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 antérieur à 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 un WDF_OBJECT_ATTRIBUTES, il spécifie NULL pour ParentObject. L’objet de configuration de l’adaptateur est automatiquement parenté à 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 |
| Version UMDF minimale | 2,33 |
| En-tête | netadapter.h (inclure netadaptercx.h) |
| Bibliothèque | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |