Função NetConfigurationOpenSubConfiguration (netconfiguration.h)

Abre uma subconsulta de um objeto de configuração de adaptador especificado.

Sintaxe

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

Parâmetros

[_In_] Configuration

Um identificador para um objeto de configuração do adaptador aberto em uma chamada anterior para NetAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.

[_In_] SubConfigurationName

Um ponteiro para uma cadeia de caracteres que especifica o nome da subconsulta a ser aberta.

[_In_opt_] SubConfigurationAttributes

Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES que contém atributos fornecidos pelo driver para o novo objeto de configuração. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] SubConfiguration

Um ponteiro para um local que recebe um identificador para o novo objeto de subconformidade.

Retornar valor

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função poderá retornar um código de erro NTSTATUS apropriado.

Comentários

Se o cliente fornecer um WDF_OBJECT_ATTRIBUTES, ele especificaRÁ NULL para ParentObject. Por padrão, a subconsulta é pai do objeto de configuração do adaptador existente.

O driver do cliente fecha a subconfiguração chamando NetConfigurationClose com o objeto de subconfiguração ou o objeto de configuração do adaptador pai.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.21
Versão mínima do UMDF	2.33
Cabeçalho	netconfiguration.h (inclua netadaptercx.h)
Biblioteca	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Confira também

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration