Função NetDeviceOpenConfiguration (netdevice.h)

A função NetDeviceOpenConfiguration abre o banco de dados de configuração de um dispositivo net.

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.

Valor de retorno

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

Observações

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 especifica 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

Consulte também

Acessando informações de configuração