NetDeviceOpenConfiguration-Funktion (netdevice.h)
Die NetDeviceOpenConfiguration-Funktion öffnet die Konfigurationsdatenbank eines Net-Gerä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 WdfDeviceCreate 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 den Speicherort, der 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 entsprechenden 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 Gerätekonfigurationsobjekt wird automatisch dem Geräteobjekt zugeordnet.
Daher löscht WDF das Konfigurationsobjekt automatisch, wenn das Gerät gelöscht wird. Der Client kann ein Konfigurationsobjekt jedoch manuell löschen, indem er WdfObjectDelete aufruft, in der Regel über die EVT_WDF_OBJECT_CONTEXT_CLEANUP Rückruffunktion.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1,27 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netdevice.h (include netadaptercx.h) |
| Bibliothek | netadaptercxstub.lib |
| IRQL | PASSIVE_LEVEL |