WDF_TIMER_CONFIG_INIT_PERIODIC函式 (wdftimer.h)

發行項
02/27/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
                        );