NetAdapterOpenConfiguration-Funktion (netadapter.h)
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 |
UMDF-Mindestversion | 2.33 |
Kopfzeile | netadapter.h (include netadaptercx.h) |
Bibliothek | NetAdapterCxStub.lib |
IRQL | PASSIVE_LEVEL |