Função NetAdapterOpenConfiguration (netadapter.h)

  • Artigo

A função NetAdapterOpenConfiguration abre o banco de dados de configuração de um adaptador de rede.

Sintaxe

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parâmetros

[_In_] Adapter

O objeto do adaptador de rede que o cliente criou em uma chamada anterior para NetAdapterCreate.

[_In_opt_] ConfigurationAttributes

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_] Configuration

Um ponteiro para um local que recebe um identificador para o novo objeto de configuração do adaptador.

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

Normalmente, o cliente chama essa função de sua função de retorno de chamada EVT_WDF_DRIVER_DEVICE_ADD.

Se o cliente fornecer um WDF_OBJECT_ATTRIBUTES, ele especificaRÁ NULL para ParentObject. O objeto de configuração do adaptador é automaticamente pai do objeto do adaptador.

Como resultado, o WDF exclui automaticamente o objeto de configuração quando o adaptador é excluído. No entanto, o cliente pode excluir manualmente um objeto de configuração chamando WdfObjectDelete, normalmente de sua função de retorno de chamada EVT_WDF_OBJECT_CONTEXT_CLEANUP .

Requisitos

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

Confira também

Acessando informações de configuração

NetConfigurationClose