Función de devolución de llamada PFNKSSETTIMER (ks.h)
Se llama a la rutina KStrSetTimer de un minidriver de streaming para generar devoluciones de llamada del temporizador DPC en función del tiempo de presentación.
Sintaxis
PFNKSSETTIMER Pfnkssettimer;
BOOLEAN Pfnkssettimer(
[in] PVOID Context,
[in] PKTIMER Timer,
[in] LARGE_INTEGER DueTime,
[in] PKDPC Dpc
)
{...}
Parámetros
[in] Context
Puntero al contexto de información proporcionado por minidriver. El minidriver pasa el contexto de información a KsAllocateDefaultClockEx en el parámetro DeferredContext de la función cuando el minidriver asigna un objeto de temporizador DPC personalizado.
[in] Timer
Puntero a un objeto de temporizador asignado por el minidriver.
[in] DueTime
Especifica el tiempo absoluto o relativo en el que expirará el temporizador. Si el valor del parámetro DueTime es negativo, la hora de expiración es relativa a la hora actual del sistema. De lo contrario, la hora de expiración es absoluta. La hora de expiración se expresa en unidades de tiempo del sistema (intervalos de 100 nanosegundos). Los tiempos de expiración absolutos realizan un seguimiento de los cambios en la hora del sistema; los tiempos de expiración relativos no se ven afectados por los cambios de hora del sistema.
[in] Dpc
Puntero a un objeto DPC que el minidriver inicializó mediante KeInitializeDpc. Este parámetro es opcional.
Valor devuelto
Devuelve TRUE si el objeto de temporizador ya estaba en la cola del temporizador del sistema. De lo contrario, devuelve FALSE.
Comentarios
Opcionalmente, los minidrivers pueden proporcionar una función de devolución de llamada KStrSetTimer como argumento a KsAllocateDefaultClockEx.
Normalmente, si un minidriver proporciona una función de devolución de llamada KStrCorrelatedTime , el minidriver también proporciona una función de devolución de llamada KStrSetTimer .
Si los minidrivers proporcionan una función de devolución de llamada KStrSetTimer , la función debe establecer temporizadores, basados en deltas, en la hora de presentación actual para generar notificaciones de eventos.
Si un minidriver proporciona una función de devolución de llamada KStrSetTimer , el minidriver también debe proporcionar una función de devolución de llamada KStrCancelTimer para cancelar el temporizador.
El minidriver proporcionado KStrSetTimer debe tener las mismas características que KeSetTimerEx.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | ks.h (incluye Ks.h) |