Share via

Accès aux informations de configuration

  • Article

L’extension de classe NetAdapterCx prend en charge un ensemble de fonctions qui fournissent l’accès aux paramètres du Registre des pilotes clients.

En règle générale, le pilote client lit les informations de configuration à partir de sa fonction de rappel EVT_WDF_DRIVER_DEVICE_ADD .

Pour un objet NetAdapter, commencez par appeler NetAdapterOpenConfiguration pour obtenir un handle à un objet de configuration. Vous pouvez ensuite l’interroger :

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’ouverture et l’interrogation d’un objet de configuration pour un appareil net sont similaires :

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

Il existe des NetConfiguration* fonctions permettant d’interroger des données ULONG, des chaînes, des chaînes multi-chaînes (comme REG_MULTI_SZ), des objets blob binaires et des adresses réseau configurables par logiciel :