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