WdfTimerGetParentObject-Funktion (wdftimer.h)
[Gilt für KMDF und UMDF]
Die WdfTimerGetParentObject-Methode gibt ein Handle an das übergeordnete Objekt eines angegebenen Frameworktimerobjekts zurück.
Syntax
WDFOBJECT WdfTimerGetParentObject(
[in] WDFTIMER Timer
);
Parameter
[in] Timer
Ein Handle für ein Framework-Timerobjekt, das durch aufrufen von WdfTimerCreate abgerufen wurde.
Rückgabewert
WdfTimerGetParentObject gibt ein Handle an das Frameworkobjekt zurück, das das übergeordnete Objekt des angegebenen Timerobjekts ist.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zu Frameworktimerobjekten finden Sie unter Verwenden von Timern.
Beispiele
Das folgende Codebeispiel zeigt nun, dass eine EvtTimerFunc-Rückruffunktion das übergeordnete Element eines Timerobjekts abrufen kann. In diesem Beispiel hat der Treiber zuvor angegeben, dass das übergeordnete Objekt des Zeitgeberobjekts ein Warteschlangenobjekt ist.
VOID
MyEvtTimerFunc(
IN WDFTIMER Timer
)
{
WDFQUEUE queue;
queue = WdfTimerGetParentObject(Timer);
...
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdftimer.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |