IWDFDriver::CreateWdfObject-Methode (wudfddi.h)

  • Artikel

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die CreateWdfObject-Methode erstellt ein benutzerdefiniertes (oder Benutzer)-WDF-Objekt aus einem übergeordneten WDF-Objekt.

Syntax

HRESULT CreateWdfObject(
  [in, optional] IUnknown   *pCallbackInterface,
  [in, optional] IWDFObject *pParentObject,
  [out]          IWDFObject **ppWdfObject
);

Parameter

[in, optional] pCallbackInterface

Ein Zeiger auf die IUnknown-Schnittstelle , die das Framework verwendet, um die objektbezogenen Ereignisrückruffunktionen zu bestimmen, die der Treiber für das neu erstellte benutzerdefinierte Objekt abonniert. Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber keine Benachrichtigung erfordert. Wenn der Treiber einen gültigen Zeiger übergibt, ruft das Framework QueryInterface auf der IUnknown-Schnittstelle für die IObjectCleanup-Schnittstelle auf. Wenn das Framework die IObjectCleanup-Schnittstelle des Treibers abruft, kann das Framework anschließend die IObjectCleanup::OnCleanup-Methode des Treibers aufrufen, um den Treiber darüber zu informieren, dass das benutzerdefinierte Objekt bereinigt wurde.

[in, optional] pParentObject

Ein Zeiger auf die IWDFObject-Schnittstelle für das übergeordnete WDF-Objekt. Bei NULL wird das Treiberobjekt zum übergeordneten Standardobjekt.

[out] ppWdfObject

Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFObject-Schnittstelle für das neu erstellte WDF-Objekt empfängt.

Rückgabewert

CreateWdfObject gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Der Treiber kann CreateWdfObject aufrufen, um ein allgemeines Framework-Basisobjekt für die eigene Verwendung zu erstellen. Der Treiber kann Kontextspeicher zuordnen, ein übergeordnetes Objekt zuweisen und eine IObjectCleanup-Schnittstelle registrieren. Das Framework ruft anschließend die IObjectCleanup::OnCleanup-Methode auf, um das untergeordnete Objekt zu sauber.

Wenn beim Parameter pParentObject kein übergeordnetes Objekt angegeben wird, wird der Treiber zum übergeordneten Standardobjekt. Wenn das Treiberobjekt gelöscht wird, bereinigt das Framework daher das untergeordnete Objekt.

Wenn ein übergeordnetes Objekt zugewiesen ist, wird das untergeordnete Objekt gelöscht, wenn das übergeordnete Objekt gelöscht wird. Anders ausgedrückt: Die Lebensdauer eines untergeordneten Objekts ist innerhalb der des übergeordneten Objekts festgelegt.

Wenn der Treiber das untergeordnete Objekt sauber muss, bevor das übergeordnete Objekt gelöscht wird, kann der Treiber die IWDFObject::D eleteWdfObject-Methode aufrufen.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform Desktop
UMDF-Mindestversion 1.5
Kopfzeile wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Weitere Informationen

IObjectCleanup

IObjectCleanup::OnCleanup

IWDFDriver

IWDFObject

IWDFObject::D eleteWdfObject