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

Weitere Informationen

Zugreifen auf Konfigurationsinformationen