Função de retorno de chamada PFNKSSETTIMER (ks.h)

Artigo
02/26/2024

A rotina KStrSetTimer de um minidriver de streaming é chamada para gerar retornos de chamada de temporizador de DPC com base no tempo de apresentação.

Sintaxe

PFNKSSETTIMER Pfnkssettimer;

BOOLEAN Pfnkssettimer(
  [in] PVOID Context,
  [in] PKTIMER Timer,
  [in] LARGE_INTEGER DueTime,
  [in] PKDPC Dpc
)
{...}

Parâmetros

[in] Context

Ponteiro para o contexto de informações fornecidas pelo minidriver. O minidriver passa o contexto de informações para KsAllocateDefaultClockEx no parâmetro DeferredContext da função quando o minidriver aloca um objeto de temporizador DPC personalizado.

[in] Timer

Ponteiro para um objeto de temporizador alocado pelo minidriver.

[in] DueTime

Especifica o tempo absoluto ou relativo no qual o temporizador deve expirar. Se o valor do parâmetro DueTime for negativo, o tempo de expiração será relativo à hora atual do sistema. Caso contrário, o tempo de expiração será absoluto. O tempo de expiração é expresso em unidades de tempo do sistema (intervalos de 100 nanossegundos). Os tempos de expiração absolutos acompanham as alterações na hora do sistema; os tempos de expiração relativos não são afetados pelas alterações de tempo do sistema.

[in] Dpc

Ponteiro para um objeto DPC que o minidriver inicializou usando KeInitializeDpc. Esse parâmetro é opcional.

Retornar valor

Retorna TRUE se o objeto de temporizador já estava na fila do temporizador do sistema. Caso contrário, retornará FALSE.

Comentários

Os minidrivers podem, opcionalmente, fornecer uma função de retorno de chamada KStrSetTimer como um argumento para KsAllocateDefaultClockEx.

Normalmente, se um minidriver fornecer uma função de retorno de chamada KStrCorrelatedTime , o minidriver também fornecerá uma função de retorno de chamada KStrSetTimer .

Se os minidrivers fornecerem uma função de retorno de chamada KStrSetTimer , a função deverá definir temporizadores, com base em deltas, para o tempo de apresentação atual para gerar notificações de eventos.

Se um minidriver fornecer uma função de retorno de chamada KStrSetTimer , o minidriver também deverá fornecer uma função de retorno de chamada KStrCancelTimer para cancelar o temporizador.

O minidriver fornecido KStrSetTimer deve ter as mesmas características que KeSetTimerEx.