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 in einem vorherigen Aufruf von NetAdapterCreateerstellt 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 für 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.
Bemerkungen
In der Regel ruft der Client diese Funktion aus der EVT_WDF_DRIVER_DEVICE_ADD Rückruffunktion auf.
Wenn der Client eine WDF_OBJECT_ATTRIBUTESbereitstellt, gibt er NULL- für ParentObject-an. Das Adapterkonfigurationsobjekt wird automatisch an das Adapterobjekt angefügt.
Daher löscht WDF automatisch das Konfigurationsobjekt, wenn der Adapter gelöscht wird. Der Client kann ein Konfigurationsobjekt jedoch manuell löschen, indem WdfObjectDeleteaufgerufen wird, in der Regel aus der EVT_WDF_OBJECT_CONTEXT_CLEANUP Rückruffunktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.21 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netadapter.h (include netadaptercx.h) |
| Library | NetAdapterCxStub.lib |
| IRQL- | PASSIVE_LEVEL |