ExCancelTimer 함수(wdm.h)

  • 아티클

ExCancelTimer 루틴은 ExSetTimer 루틴에 대한 이전 호출에 의해 설정된 타이머를 취소합니다.

구문

BOOLEAN ExCancelTimer(
  [in, out]      PEX_TIMER              Timer,
  [in, optional] PEXT_CANCEL_PARAMETERS Parameters
);

매개 변수

[in, out] Timer

EX_TIMER 구조체에 대한 포인터입니다. 이 구조체는 ExAllocateTimer 루틴에 의해 이전에 할당된 타이머 개체입니다.

[in, optional] Parameters

드라이버는 이 매개 변수를 NULL로 설정해야 합니다.

반환 값

타이머가 취소된 경우 이 루틴은 TRUE 를 반환합니다. 그렇지 않으면 루틴이 FALSE를 반환 합니다.

설명

드라이버가 ExSetTimer 루틴을 호출하여 타이머를 설정한 후 타이머가 만료되기 전에 취소될 수 있습니다. 드라이버는 ExCancelTimer 루틴을 호출하여 보류 중인 타이머를 명시적으로 취소할 수 있습니다. 또한 드라이버가 ExSetTimer 루틴을 호출하여 이 개체에 대해 이전에 설정한 타이머가 만료되기 전에 타이머 개체에 새 타이머를 설정하는 경우 이 ExSetTimer 호출은 암시적으로 이전 타이머를 취소한 다음 새 타이머를 시작합니다.

반환 값 TRUE는 ExCancelTimer가 호출되었을 때 타이머가 설정되었음을 나타냅니다. 이 경우 루틴은 타이머를 취소합니다. FALSE의 반환 값은 타이머가 설정되지 않았거나, 타이머가 설정되지 않았거나, 타이머가 이미 취소되었거나, 타이머가 이미 만료되었음을 의미합니다.

타이머가 만료되면 운영 체제는 타이머 개체에 신호를 보냅니다. 옵션으로 드라이버는 타이머가 만료되면 호출되는 ExTimerCallback 콜백 루틴을 제공할 수 있습니다. 드라이버가 이 콜백 루틴을 제공하는 경우 타이머 개체가 신호를 받으면 이 루틴이 호출되도록 보장됩니다. 타이머가 만료되기 전에 취소되면 타이머 개체에 신호가 표시되지 않고 콜백 루틴이 호출되지 않습니다.

자세한 내용은 ExXxxTimer 루틴 및 EX_TIMER 개체를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 시작해서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 Ntoskrnl.lib
IRQL <= DISPATCH_LEVEL

추가 정보

EX_TIMER

ExAllocateTimer

ExSetTimer