Função de retorno de chamada PTIMERAPCROUTINE (synchapi.h)

  • Artigo

Uma rotina de conclusão de temporizador definida pelo aplicativo. Especifique esse endereço ao chamar a função SetWaitableTimer . O tipo PTIMERAPCROUTINE define um ponteiro para essa função de retorno de chamada. TimerAPCProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PTIMERAPCROUTINE Ptimerapcroutine;

void Ptimerapcroutine(
  [in, optional] LPVOID lpArgToCompletionRoutine,
  [in]           DWORD dwTimerLowValue,
  [in]           DWORD dwTimerHighValue
)
{...}

Parâmetros

[in, optional] lpArgToCompletionRoutine

O valor passado para a função usando o parâmetro lpArgToCompletionRoutine da função SetWaitableTimer .

[in] dwTimerLowValue

A parte de baixa ordem da hora baseada em UTC em que o temporizador foi sinalizado. Esse valor corresponde ao membro dwLowDateTime da estrutura FILETIME . Para obter mais informações sobre a hora baseada em UTC, consulte Hora do sistema.

[in] dwTimerHighValue

A parte de alta ordem do tempo baseado em UTC em que o temporizador foi sinalizado. Esse valor corresponde ao membro dwHighDateTime da estrutura FILETIME .

Retornar valor

Nenhum

Comentários

A rotina de conclusão é executada pelo thread que ativa o temporizador usando SetWaitableTimer. No entanto, o thread deve estar em um estado alertável. Para obter mais informações, consulte Chamadas de procedimento assíncrono.

Exemplos

Para obter um exemplo, consulte Usando um temporizador de espera com uma chamada de procedimento assíncrono.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho synchapi.h (inclua Windows.h)

Confira também

SetWaitableTimer