NetDeviceOpenConfiguration, fonction (netdevice.h)

  • Article

La fonction NetDeviceOpenConfiguration ouvre la base de données de configuration d’un appareil net.

Syntaxe

NTSTATUS NetDeviceOpenConfiguration(
  [_In_]     WDFDEVICE             Device,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Paramètres

[_In_] Device

Objet WDFDEVICE que le pilote client a créé précédemment avec un appel à WdfDeviceCreate.

[_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 l’emplacement qui reçoit le nouvel objet NETCONFIGURATION.

Valeur retournée

Cette 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’appareil est automatiquement parenté à l’objet d’appareil.

Par conséquent, WDF supprime automatiquement l’objet de configuration lorsque l’appareil 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,27 %
En-tête netdevice.h (inclure netadaptercx.h)
Bibliothèque netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi

Accès aux informations de configuration