IWDFDriver::CreateWdfObject-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die CreateWdfObject--Methode erstellt ein benutzerdefiniertes WDF-Objekt (oder ein Benutzerobjekt) 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 hat. 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 wird.
[in, optional] pParentObject
Ein Zeiger auf die IWDFObject Schnittstelle für das übergeordnete WDF-Objekt. Wenn 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.
Bemerkungen
Der Treiber kann CreateWdfObject- aufrufen, um ein allgemeines Framework-Basisobjekt für die eigene Verwendung zu erstellen. Der Treiber kann den 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 bereinigen.
Wenn an der pParentObject Parameter 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. Mit anderen Worten, die Lebensdauer eines untergeordneten Objekts wird innerhalb des übergeordneten Objekts festgelegt.
Wenn der Treiber das untergeordnete Objekt bereinigen 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |