Función NetConfigurationOpenSubConfiguration (netconfiguration.h)

Abre una subconfiguración de un objeto de configuración de adaptador especificado.

Sintaxis

NTSTATUS NetConfigurationOpenSubConfiguration(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      SubConfigurationName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *SubConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *SubConfiguration
);

Parámetros

[_In_] Configuration

Identificador de un objeto de configuración de adaptador abierto en una llamada anterior a NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

[_In_] SubConfigurationName

Puntero a una cadena que especifica el nombre de la subconfiguración que se va a abrir.

[_In_opt_] SubConfigurationAttributes

Puntero a una estructura WDF_OBJECT_ATTRIBUTES que contiene atributos proporcionados por el controlador para el nuevo objeto de configuración. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] SubConfiguration

Puntero a una ubicación que recibe un identificador para el nuevo objeto de subconfiguración.

Valor devuelto

La función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Comentarios

Si el cliente proporciona un WDF_OBJECT_ATTRIBUTES, especifica NULL para ParentObject. De forma predeterminada, la subconfiguración está primaria en el objeto de configuración del adaptador existente.

El controlador cliente cierra la subconfiguración mediante una llamada a NetConfigurationClose con el objeto de subconfiguración o el objeto de configuración del adaptador primario.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.21
Encabezado	netconfiguration.h (include netadaptercx.h)
Library	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Consulte también

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration