Función IoInitializeTimer (wdm.h)

La rutina IoInitializeTimer configura una rutina ioTimer proporcionada por el controlador asociada a un objeto de dispositivo determinado.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero a un objeto de dispositivo que representa un dispositivo en el que las operaciones de E/S pueden agotar el tiempo de espera.

[in] TimerRoutine

Puntero a la rutina IoTimer proporcionada por el controlador.

[in, optional] Context

Puntero al contexto determinado por el controlador con el que se llamará a su rutina de IoTimer .

Valor devuelto

IoInitializeTimer devuelve STATUS_SUCCESS si se configura la rutina IoTimer .

Comentarios

Se debe llamar a IoInitializeTimer solo una vez por objeto de dispositivo.

Se llama a la rutina IoTimer de un controlador una vez por segundo después de que el controlador habilite el temporizador mediante una llamada a IoStartTimer. El controlador puede deshabilitar el temporizador llamando a IoStopTimer y puede volver a habilitarlo con IoStartTimer.

Se llama a la rutina IoTimer del controlador en IRQL = DISPATCH_LEVEL y, por lo tanto, no debe contener código paginable.

Cuando se ejecuta el temporizador, el administrador de E/S llama a la rutina IoTimer proporcionada por el controlador una vez por segundo. Los controladores cuyas rutinas de tiempo de espera deben llamarse a intervalos variables o a intervalos de granularidad más fina pueden configurar una rutina CustomTimerDpc y usar las rutinas del temporizador KeXxx.

Requisitos

   
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Header wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Vea también

IoStartTimer

IoStopTimer

IoTimer

KeInitializeTimer

KeSetTimer