Função NdisCancelTimerObject (ndis.h)

A função NdisCancelTimerObject cancela um objeto de temporizador associado a uma chamada anterior à função NdisSetTimerObject .

Sintaxe

BOOLEAN NdisCancelTimerObject(
  [in] NDIS_HANDLE TimerObject
);

Parâmetros

[in] TimerObject

Um identificador para um objeto de temporizador que o NDIS fornece quando um driver chama o Função NdisAllocateTimerObject .

Retornar valor

NdisCancelTimerObject retornará TRUE se o objeto de temporizador especificado estiver na fila do temporizador do sistema; caso contrário, retornará FALSE.

Comentários

Uma chamada para NdisCancelTimerObject cancela a execução de uma função NetTimerCallback , desde que o último intervalo de tempo limite especificado ainda não tenha expirado.

Os drivers NDIS devem chamar NdisCancelTimerObject primeiro quando estiverem parando ou descarregando para garantir que uma função NetTimerCallback não tente acessar os recursos que o driver já liberou.

Se um valor diferente de zero tiver sido especificado no parâmetro MillisecondsPeriod da função NdisSetTimerObject , o temporizador será conhecido como um temporizador periódico. Se um valor zero tiver sido especificado no parâmetro MillisecondsPeriod , o temporizador será conhecido como um temporizador único. Os seguintes pontos se aplicam ao cancelamento de ambos os tipos de temporizadores:

• Se o chamador de NdisCancelTimerObject estiver cancelando um temporizador periódico, ele deverá estar em execução em IRQL = PASSIVE_LEVEL. Caso contrário, o chamador de NdisCancelTimerObject deverá estar em execução em IRQL <= DISPATCH_LEVEL.
• Se o chamador de NdisCancelTimerObject estiver cancelando um temporizador periódico, NdisCancelTimerObject chamará KeFlushQueuedDpcs para garantir que o temporizador não esteja em execução no momento. Portanto, o chamador não precisa ter um mecanismo de sincronização separado para garantir que o temporizador não esteja sendo executado em outro processador.

  Se o chamador de NdisCancelTimerObject estiver cancelando um temporizador único, será necessário que o chamador tenha um mecanismo de sincronização separado para garantir que o temporizador não esteja em execução em outro processador no momento. Por exemplo, o chamador pode chamar NDIS_WAIT_FOR_MUTEX para aguardar o thread do temporizador sinalizar um objeto mutex quando o thread estiver prestes a ser concluído.

  Para obter mais informações, consulte Sincronização e notificação em drivers de rede.

Requisitos

Confira também

NdisAllocateTimerObject

NdisSetTimerObject

NetTimerCallback