Zugreifen auf Konfigurationsinformationen

  • Artikel

Die NetAdapterCx-Klassenerweiterung unterstützt eine Reihe von Funktionen, die Zugriff auf Registrierungsparameter des Clienttreibers ermöglichen.

In der Regel liest der Clienttreiber Konfigurationsinformationen aus seiner EVT_WDF_DRIVER_DEVICE_ADD Rückruffunktion.

Für ein NetAdapter-Objekt rufen Sie zunächst NetAdapterOpenConfiguration auf, um ein Handle für ein Konfigurationsobjekt abzurufen. Sie können ihn dann abfragen:

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

Das Öffnen und Abfragen eines Konfigurationsobjekts für ein Netzgerät ist ähnlich:

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

Es gibt NetConfiguration* Funktionen zum Abfragen von ULONG-Daten, Zeichenfolgen, Multizeichenfolgen (ähnlich REG_MULTI_SZ), binären Blobs und softwarekonfigurierbaren Netzwerkadressen: