WdfObjectCreate-Funktion (wdfobject.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfObjectCreate-Methode erstellt ein allgemeines Frameworkobjekt.

Syntax

NTSTATUS WdfObjectCreate(
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          WDFOBJECT              *Object
);

Parameter

[in, optional] Attributes

Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur , die vom Treiber bereitgestellte Attribute für das neue Objekt enthält. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] Object

Ein Zeiger auf eine Position, die ein Handle auf das neue Frameworkobjekt empfängt.

Rückgabewert

WdfObjectCreate gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Eine Liste mit zusätzlichen Rückgabewerten finden Sie unter Fehler beim Erstellen von Frameworkobjekten.

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Hinweise

Standardmäßig ist das übergeordnete Element des neuen allgemeinen Frameworkobjekts das Frameworktreiberobjekt, das von der WdfDriverCreate-Methode erstellt wurde. Sie können das ParentObject-Element der WDF_OBJECT_ATTRIBUTES-Struktur verwenden, um ein anderes übergeordnetes Element anzugeben. Das Framework löscht das allgemeine Objekt, wenn es das übergeordnete Objekt löscht. Wenn Ihr Treiber das übergeordnete Standardobjekt nicht ändert, sollte der Treiber das allgemeine Objekt löschen, wenn er das Objekt verwendet hat. Andernfalls verbleibt das Objekt, bis der E/A-Manager Den Treiber entladen hat.

Weitere Informationen zur WdfObjectCreate-Methode finden Sie unter Verwenden von allgemeinen Frameworkobjekten.

Weitere Informationen zu den Bereinigungsregeln für eine Frameworkobjekthierarchie finden Sie unter Framework-Objektlebenszyklus.

Beispiele

Im folgenden Codebeispiel wird eine WDF_OBJECT_ATTRIBUTES-Struktur initialisiert und ein allgemeines Frameworkobjekt erstellt.

WDF_OBJECT_ATTRIBUTES  Attributes;
WDFOBJECT  Object;

WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
                         &Attributes,
                         &Object
                         );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfobject.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WdfDriverCreate

WdfObjectDelete