Função NetDeviceOpenConfiguration (netdevice.h)

  • Artigo

A função NetDeviceOpenConfiguration abre o banco de dados de configuração de um dispositivo líquido.

Sintaxe

NTSTATUS NetDeviceOpenConfiguration(
  [_In_]     WDFDEVICE             Device,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parâmetros

[_In_] Device

O objeto WDFDEVICE que o driver cliente criou anteriormente com uma chamada para WdfDeviceCreate.

[_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 o local que recebe o novo objeto NETCONFIGURATION.

Retornar valor

Essa 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 dispositivo é automaticamente pai do objeto do dispositivo.

Como resultado, o WDF exclui automaticamente o objeto de configuração quando o dispositivo é 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.27
Cabeçalho netdevice.h (inclua netadaptercx.h)
Biblioteca netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Acessando informações de configuração