NetDeviceOpenConfiguration-Funktion (netdevice.h)
Die NetDeviceOpenConfiguration--Funktion öffnet die Konfigurationsdatenbank eines Netzgeräts.
Syntax
NTSTATUS NetDeviceOpenConfiguration(
[_In_] WDFDEVICE Device,
[_In_opt_] WDF_OBJECT_ATTRIBUTES *ConfigurationAttributes,
[_Out_] NETCONFIGURATION *Configuration
);
Parameter
[_In_] Device
Das WDFDEVICE-Objekt, das der Clienttreiber zuvor mit einem Aufruf von WdfDeviceCreateerstellt 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_ATTRIBUTESwerden.
[_Out_] Configuration
Ein Zeiger auf die Position, die das neue NETCONFIGURATION-Objekt empfängt.
Rückgabewert
Diese 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 Gerätekonfigurationsobjekt wird automatisch an das Geräteobjekt angefügt.
Daher löscht WDF automatisch das Konfigurationsobjekt, wenn das Gerät 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.27 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netdevice.h (include netadaptercx.h) |
| Library | netadaptercxstub.lib |
| IRQL- | PASSIVE_LEVEL |