NetConfigurationOpenSubConfiguration, fonction (netconfiguration.h)
Ouvre une sous-configuration d’un objet de configuration d’adaptateur spécifié.
Syntaxe
NTSTATUS NetConfigurationOpenSubConfiguration(
[_In_] NETCONFIGURATION Configuration,
[_In_] PCUNICODE_STRING SubConfigurationName,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
[_Out_] NETCONFIGURATION *SubConfiguration
);
Paramètres
[_In_] Configuration
Handle à un objet de configuration d’adaptateur ouvert lors d’un appel antérieur à NetAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.
[_In_] SubConfigurationName
Pointeur vers une chaîne spécifiant le nom de la sous-configuration à ouvrir.
[_In_opt_] SubConfigurationAttributes
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_] SubConfiguration
Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet de sous-configuration.
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
Si le client fournit une WDF_OBJECT_ATTRIBUTES, il spécifie NULL pour ParentObject. Par défaut, la sous-configuration est parentée avec l’objet de configuration de l’adaptateur existant.
Le pilote client ferme la sous-configuration en appelant NetConfigurationClose avec l’objet de sous-configuration ou l’objet de configuration de l’adaptateur parent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.21 |
| Version UMDF minimale | 2,33 |
| En-tête | netconfiguration.h (inclure netadaptercx.h) |
| Bibliothèque | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |