Función de devolución de llamada PFNKSSETTIMER (ks.h)

Se llama a la rutina KStrSetTimer de un minidrive r 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 de 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 expira 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. El tiempo 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 en la 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.

Observaciones

Los minidrivers pueden proporcionar opcionalmente una función de devolución de llamada de KStrSetTimer como argumento para 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 un KStrSetTimer función de devolución de llamada, 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 un KStrCancelTimer función de devolución de llamada para cancelar el temporizador.

El minidriver proporcionado KStrSetTimer debe tener las mismas características que KeSetTimerEx.

Requisitos

Consulte también

KStrCancelTimer

KeInitializeDpc

KeSetTimerEx

KsAllocateDefaultClockEx