Função IoInitializeTimer (wdm.h)

Artigo
02/29/2024

A rotina IoInitializeTimer configura uma rotina IoTimer fornecida pelo driver associada a um determinado objeto de dispositivo.

Sintaxe

NTSTATUS IoInitializeTimer(
  [in]           PDEVICE_OBJECT         DeviceObject,
  [in]           PIO_TIMER_ROUTINE      TimerRoutine,
  [in, optional] __drv_aliasesMem PVOID Context
);

Parâmetros

[in] DeviceObject

Ponteiro para um objeto de dispositivo que representa um dispositivo no qual as operações de E/S podem atingir o tempo limite.

[in] TimerRoutine

Ponteiro para a rotina IoTimer fornecida pelo driver.

[in, optional] Context

Ponteiro para o contexto determinado pelo driver com o qual sua rotina IoTimer será chamada.

Retornar valor

IoInitializeTimer retornará STATUS_SUCCESS se a rotina IoTimer estiver configurada.

Comentários

IoInitializeTimer deve ser chamado apenas uma vez por objeto de dispositivo.

A rotina IoTimer de um driver é chamada uma vez por segundo depois que o driver habilita o temporizador chamando IoStartTimer. O driver pode desabilitar o temporizador chamando IoStopTimer e pode reabilitá-lo novamente com IoStartTimer.

A rotina IoTimer do driver é chamada em IRQL = DISPATCH_LEVEL e, portanto, não deve conter código paginável.

Quando o temporizador está em execução, o gerente de E/S chama a rotina de IoTimer fornecida pelo driver uma vez por segundo. Os drivers cujas rotinas de tempo limite devem ser chamadas em intervalos variáveis ou em intervalos de granularidade mais fina podem configurar uma rotina CustomTimerDpc e usar as rotinas do Temporizador KeXxx.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)