NetDeviceOpenConfiguration, fonction (netdevice.h)

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 créé précédemment avec un appel à WdfDeviceCreate.

[_In_opt_] ConfigurationAttributes

Pointeur vers une structure 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 de retour

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 un WDF_OBJECT_ATTRIBUTES, il spécifie NULL pour ParentObject. L’objet de configuration de l’appareil est automatiquement parenté de 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.

Exigences

Voir aussi

accès aux informations de configuration