Função NetAdapterOpenConfiguration (netadapter.h)
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 pode 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 |
| Versão mínima do UMDF | 2.33 |
| Cabeçalho | netadapter.h (inclua netadaptercx.h) |
| Biblioteca | NetAdapterCxStub.lib |
| IRQL | PASSIVE_LEVEL |