WdfTimerGetParentObject-Funktion (wdftimer.h)

  • Artikel

[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)

Weitere Informationen

WdfTimerCreate