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 de 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 |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.21 |
| versión mínima de UMDF | 2.33 |
| encabezado de | netconfiguration.h (include netadaptercx.h) |
| biblioteca de | NetAdapterCxStub.lib |
| irQL | PASSIVE_LEVEL |