Função NetConfigurationOpenSubConfiguration (netconfiguration.h)

  • Artigo

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 subconsulta.

Retornar valor

A função retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função pode 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 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
Cabeçalho netconfiguration.h (include netadaptercx.h)
Biblioteca NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

Confira também

NetAdapterOpenConfiguration

NetConfigurationOpenSubConfiguration