Acessando informações de configuração

  • Artigo

A extensão de classe NetAdapterCx dá suporte a um conjunto de funções que fornecem acesso aos parâmetros do registro de driver de cliente.

Normalmente, o driver do cliente lê informações de configuração de sua função de retorno de chamada EVT_WDF_DRIVER_DEVICE_ADD.

Para um objeto NetAdapter, comece chamando NetAdapterOpenConfiguration para obter um identificador para um objeto de configuração. Em seguida, você pode consultá-lo:

NETCONFIGURATION configuration;

status = NetAdapterOpenConfiguration(NetAdapter, 
                                     WDF_NO_OBJECT_ATTRIBUTES, 
                                     &configuration);
if (!NT_SUCCESS(status)) {
    return status;
}

status = NetConfigurationQueryUlong(configuration, 
                                    NET_CONFIGURATION_QUERY_ULONG_NO_FLAGS, 
                                    &SomeValue, 
                                    &myvalue);

NetConfigurationClose(configuration);

Abrir e consultar um objeto de configuração para um dispositivo líquido é semelhante:

status = NetDeviceOpenConfiguration(Device, 
                                    WDF_NO_OBJECT_ATTRIBUTES, 
                                    &configuration);
if(!NT_SUCCESS(status))
{
    return status;
}

WDFCOLLECTION myStrings;

DECLARE_CONST_UNICODE_STRING(myValueName, L"ExampleValueName");

status = NetConfigurationQueryMultiString(configuration,
                                          myValueName,
                                          WDF_NO_OBJECT_ATTRIBUTES,
                                          myStrings);

Há NetConfiguration* funções para consultar dados ULONG, cadeias de caracteres, várias cadeias de caracteres (semelhantes a REG_MULTI_SZ), blobs binários e endereços de rede configuráveis pelo software: