Condividi tramite


Accesso alle informazioni di configurazione

L'estensione della classe NetAdapterCx supporta un set di funzioni che forniscono l'accesso ai parametri del Registro di sistema dei driver client.

In genere, il driver client legge le informazioni di configurazione dalla sua funzione di callback EVT_WDF_DRIVER_DEVICE_ADD.

Per un oggetto NetAdapter, iniziare chiamando NetAdapterOpenConfiguration per ottenere un handle a un oggetto di configurazione. È quindi possibile eseguire una query su di esso:

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);

L'apertura e l'esecuzione di query su un oggetto di configurazione per un dispositivo net sono simili:

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);

Esistono NetConfiguration* funzioni per l'esecuzione di query su dati ULONG, stringhe, stringhe multiple (simili a REG_MULTI_SZ), BLOB binari e indirizzi di rete configurabili dal software.