IO_TIMER_ROUTINE función de devolución de llamada (wdm.h)

La rutina IoTimer es un DPC que, si está registrado, se llama una vez por segundo.

Sintaxis

IO_TIMER_ROUTINE IoTimerRoutine;

void IoTimerRoutine(
  [in]           _DEVICE_OBJECT *DeviceObject,
  [in, optional] PVOID Context
)
{...}

Parámetros

[in] DeviceObject

Puntero proporcionado por el autor de la llamada a una estructura DEVICE_OBJECT . Este es el objeto de dispositivo para el dispositivo de destino, creado previamente por la rutina AddDevice del controlador.

[in, optional] Context

Puntero proporcionado por el llamador a la información de contexto definida por el controlador, especificada en una llamada anterior a IoInitializeTimer.

Valor devuelto

None

Observaciones

La rutina ioTimer de un controlador se ejecuta en un contexto DPC, en IRQL = DISPATCH_LEVEL.

Un controlador puede asociar una rutina de IoTimer con cada objeto de dispositivo que crea. (Puede usar una sola rutina de IoTimer con varios objetos de dispositivo o una rutina independiente con cada objeto de dispositivo). Para registrar una rutina de IoTimer , un controlador debe llamar a IoInitializeTimer, proporcionando la dirección de la rutina IoTimer y un puntero de objeto de dispositivo.

Para poner en cola una rutina de IoTimer para su ejecución, una rutina de controlador debe llamar a IoStartTimer. El sistema llama a la rutina IoTimer una vez por segundo hasta que el controlador llama a IoStopTimer.

Para obtener más información sobre las rutinas de IoTimer , consulte Rutinas de IoTimer.

Ejemplos

Para definir una rutina de devolución de llamada de IoTimer , primero debe proporcionar una declaración de función que identifique el tipo de rutina de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Análisis de código para controladores, Comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una rutina de devolución de llamada de IoTimer denominada MyIoTimer, use el tipo IO_TIMER_ROUTINE como se muestra en este ejemplo de código:

IO_TIMER_ROUTINE MyIoTimer;

A continuación, implemente la rutina de devolución de llamada de la siguiente manera:

_Use_decl_annotations_
VOID
  MyIoTimer(
    struct DEVICE_OBJECT  *DeviceObject,
    PVOID  Context
    )
  {
      // Function body
  }

El tipo de función IO_TIMER_ROUTINE se define en el archivo de encabezado Wdm.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función IO_TIMER_ROUTINE en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante el uso de tipos de roles de función para controladores WDM. Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

   
Plataforma de destino Escritorio
Header wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL Se llama en DISPATCH_LEVEL (consulte la sección Comentarios).