WdfTimerGetParentObject-Funktion (wdftimer.h)

Artikel
07.02.2025

[Gilt für KMDF und UMDF]

Die WdfTimerGetParentObject--Methode gibt ein Handle an das übergeordnete Objekt eines angegebenen Frameworktimerobjekts zurück.

Syntax

C++

WDFOBJECT WdfTimerGetParentObject(
  [in] WDFTIMER Timer
);

Parameter

[in] Timer

Ein Handle für ein Framework-Timerobjekt, das durch Aufrufen WdfTimerCreateabgerufen wurde.

Rückgabewert

WdfTimerGetParentObject gibt ein Handle an das Frameworkobjekt zurück, das das übergeordnete Objekt des angegebenen Zeitgeberobjekts ist.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu Framework-Timerobjekten finden Sie unter Using Timers.

Beispiele

Im folgenden Codebeispiel wird nun ein EvtTimerFunc- Rückruffunktion das übergeordnete Element eines Timerobjekts abrufen. In diesem Beispiel hat der Treiber zuvor angegeben, dass das übergeordnete Objekt des Zeitgeberobjekts ein Warteschlangenobjekt ist.

C++

VOID
MyEvtTimerFunc(
    IN WDFTIMER  Timer
    )
{
    WDFQUEUE queue;

    queue = WdfTimerGetParentObject(Timer);
...
}

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdftimer.h (include Wdf.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf)

Siehe auch

WdfTimerCreate-

Freigeben über