função WDF_TIMER_CONFIG_INIT_PERIODIC (wdftimer.h)

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

A função WDF_TIMER_CONFIG_INIT_PERIODIC inicializa uma estrutura de WDF_TIMER_CONFIG para um temporizador periódico.

Sintaxe

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

Parâmetros

[in] Config

Um ponteiro para uma estrutura WDF_TIMER_CONFIG.

[in] EvtTimerFunc

Um ponteiro para uma função de retorno de chamada EvtTimerFunc fornecida pelo driver.

[in] Period

Um valor de tempo. Para obter mais informações sobre como especificar esse valor, consulte WDF_TIMER_CONFIG.

Valor de retorno

Nenhum

Observações

A função WDF_TIMER_CONFIG_INIT_PERIODIC zera a estrutura de WDF_TIMER_CONFIG especificada. Em seguida, ele define o membro tamanho da estrutura, armazena o ponteiro EvtTimerFunc e o valor de Período, define o membro TolerávelDelay como zero e define o membro de AutomaticSerialization como TRUE.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de WDF_TIMER_CONFIG e uma estrutura WDF_OBJECT_ATTRIBUTES e, em seguida, chama 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
                        );

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdftimer.h (inclua Wdf.h)
biblioteca	Nenhum
IRQL	Qualquer nível

Consulte também

EvtTimerFunc

WDF_TIMER_CONFIG

WDF_TIMER_CONFIG_INIT

Compartilhar via