NetConfigurationOpenSubConfiguration, fonction (netconfiguration.h)

  • Article

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 d’un objet de configuration d’adaptateur ouvert dans 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 un 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
En-tête netconfiguration.h (inclure netadaptercx.h)
Bibliothèque NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

Voir aussi

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration