WDF_TIMER_CONFIG_INIT_PERIODIC 函数 (wdftimer.h)

项目
02/29/2024

[适用于 KMDF 和 UMDF]

WDF_TIMER_CONFIG_INIT_PERIODIC 函数初始化定期计时器的WDF_TIMER_CONFIG结构。

语法

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

参数

[in] Config

指向 WDF_TIMER_CONFIG 结构的指针。

[in] EvtTimerFunc

指向驱动程序提供的 EvtTimerFunc 回调函数的指针。

[in] Period

时间值。有关指定此值的详细信息，请参阅 WDF_TIMER_CONFIG。

返回值

无

备注

WDF_TIMER_CONFIG_INIT_PERIODIC函数将指定的WDF_TIMER_CONFIG结构归零。然后，它将设置结构的 Size 成员，存储 EvtTimerFunc 指针和 Period 值，将 TolerableDelay 成员设置为零，并将 AutomaticSerialization 成员设置为 TRUE。

示例

下面的代码示例初始化 WDF_TIMER_CONFIG 结构和 WDF_OBJECT_ATTRIBUTES 结构，然后调用 WdfTimerCreate。

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