NetAdapterOpenConfiguration-Funktion (netadapter.h)

  • Artikel

Die NetAdapterOpenConfiguration-Funktion öffnet die Konfigurationsdatenbank eines Netzadapters.

Syntax

NTSTATUS NetAdapterOpenConfiguration(
  [_In_]     NETADAPTER            Adapter,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
  [_Out_]    NETCONFIGURATION      *Configuration
);

Parameter

[_In_] Adapter

Das Netzwerkadapterobjekt, das der Client vor einem Aufruf von NetAdapterCreate erstellt hat.

[_In_opt_] ConfigurationAttributes

Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur , die vom Treiber bereitgestellte Attribute für das neue Konfigurationsobjekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[_Out_] Configuration

Ein Zeiger auf einen Speicherort, der ein Handle auf das neue Adapterkonfigurationsobjekt empfängt.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion möglicherweise einen geeigneten NTSTATUS-Fehlercode zurück.

Hinweise

In der Regel ruft der Client diese Funktion über seine EVT_WDF_DRIVER_DEVICE_ADD Rückruffunktion auf.

Wenn der Client eine WDF_OBJECT_ATTRIBUTES bereitstellt, gibt er NULL für ParentObject an. Das Adapterkonfigurationsobjekt wird automatisch dem Adapterobjekt zugeordnet.

Daher löscht WDF das Konfigurationsobjekt automatisch, wenn der Adapter gelöscht wird. Der Client kann jedoch ein Konfigurationsobjekt manuell löschen, indem er WdfObjectDelete aufruft, in der Regel über seine EVT_WDF_OBJECT_CONTEXT_CLEANUP Rückruffunktion.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.21
Kopfzeile netadapter.h (include netadaptercx.h)
Bibliothek NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

Zugreifen auf Konfigurationsinformationen

NetConfigurationClose