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 par le pilote client 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 % |
| Version UMDF minimale | 2,33 |
| En-tête | netdevice.h (inclure netadaptercx.h) |
| Bibliothèque | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |