Função KeInitializeTimer (wdm.h)

Artigo
02/27/2024

A rotina KeInitializeTimer inicializa um objeto de temporizador.

Sintaxe

void KeInitializeTimer(
  [out] PKTIMER Timer
);

Parâmetros

[out] Timer

Ponteiro para um objeto de temporizador, para o qual o chamador fornece o armazenamento.

Retornar valor

Nenhum

Comentários

O objeto timer é inicializado para um estado não sinalizado.

O armazenamento de um objeto de temporizador deve ser residente: na extensão do dispositivo de um objeto de dispositivo criado pelo driver, na extensão do controlador de um objeto de controlador criado pelo driver ou no pool nãopagado alocado pelo chamador.

KeInitializeTimer só pode inicializar um temporizador de notificação. Use KeInitializeTimerEx para inicializar um temporizador de notificação ou um temporizador de sincronização.

Use KeSetTimer ou KeSetTimerEx para definir quando o temporizador expirará.

Para obter mais informações sobre objetos de temporizador, consulte Objetos do Temporizador e DPCs.

Os chamadores de KeInitializeTimer devem estar em execução em IRQL = DISPATCH_LEVEL ou inferior. É melhor inicializar temporizadores em IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows 2000.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (consulte a seção Comentários)
Regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlKeDispatchLte(wdm)