WDF_TIMER_CONFIG_INIT_PERIODIC-Funktion (wdftimer.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_TIMER_CONFIG_INIT_PERIODIC-Funktion initialisiert eine WDF_TIMER_CONFIG-Struktur für einen regelmäßigen Timer.

Syntax

void WDF_TIMER_CONFIG_INIT_PERIODIC(
  [in] PWDF_TIMER_CONFIG Config,
  [in] PFN_WDF_TIMER     EvtTimerFunc,
  [in] LONG              Period
);

Parameter

[in] Config

Ein Zeiger auf eine WDF_TIMER_CONFIG-Struktur .

[in] EvtTimerFunc

Ein Zeiger auf eine vom Treiber bereitgestellte EvtTimerFunc-Rückruffunktion .

[in] Period

Ein time-Wert. Weitere Informationen zum Angeben dieses Werts finden Sie unter WDF_TIMER_CONFIG.

Rückgabewert

Keine

Bemerkungen

Die WDF_TIMER_CONFIG_INIT_PERIODIC-Funktion stellt die angegebene WDF_TIMER_CONFIG-Struktur auf Null. Anschließend wird das Size-Element der Struktur festgelegt, der EvtTimerFunc-Zeiger und der Period-Wert gespeichert, der TolerableDelay-Member auf 0 festgelegt und das Element AutomaticSerialization auf TRUE festgelegt.

Beispiele

Im folgenden Codebeispiel werden eine WDF_TIMER_CONFIG-Struktur und eine WDF_OBJECT_ATTRIBUTES-Struktur initialisiert und anschließend WdfTimerCreate aufgerufen.

WDF_TIMER_CONFIG  timerConfig;
WDF_OBJECT_ATTRIBUTES  timerAttributes;
WDFTIMER  timerHandle;
NTSTATUS  Status;

WDF_TIMER_CONFIG_INIT_PERIODIC(
                               &timerConfig,
                               EchoEvtTimerFunc,
                               PERIODIC_TIMER_INTERVAL
                               );

WDF_OBJECT_ATTRIBUTES_INIT(&timerAttributes);
timerAttributes.ParentObject = Queue;

Status = WdfTimerCreate(
                        &timerConfig,
                        &timerAttributes,
                        &timerHandle
                        );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdftimer.h (include Wdf.h)
Bibliothek	Keine
IRQL	Beliebige Ebene

Weitere Informationen

EvtTimerFunc

WDF_TIMER_CONFIG

WDF_TIMER_CONFIG_INIT

Freigeben über