Função de retorno de chamada PFNKSSETTIMER (ks.h)
A rotina KStrSetTimer de um minidriver de streaming é chamada para gerar retornos de chamada do temporizador DPC com base no tempo da 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 em que o temporizador deve expirar. Se o valor do parâmetro DueTime for negativo, o tempo de expiração será relativo ao tempo 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.
Valor de retorno
Retorna VERDADEIRO se o objeto de temporizador já estava na fila do temporizador do sistema. Caso contrário, retornará FALSE .
Observações
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 um KStrSetTimer função de retorno de chamada, a função deverá definir temporizadores, com base em deltas, para o tempo de apresentação atual para gerar notificações de evento.
Se um minidriver fornecer uma função de retorno de chamada KStrSetTimer, o minidriver também deverá fornecer um KStrCancelTimer função de retorno de chamada para cancelar o temporizador.
O minidriver fornecido KStrSetTimer deve ter as mesmas características que keSetTimerEx.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ks.h (incluir Ks.h) |