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 se puede WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] SubConfiguration

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

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.

Observaciones

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 llamando a NetConfigurationClose con el objeto de configuración secundaria o el objeto de configuración del adaptador primario.

Requisitos

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

Consulte también

NetAdapterOpenConfiguration