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 |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netconfiguration.h (include netadaptercx.h) |
| Library | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |