ExDeleteTimer 함수(wdm.h)

아티클
02/29/2024

ExDeleteTimer 루틴은 ExAllocateTimer 루틴에 의해 이전에 할당된 타이머 개체를 삭제합니다.

구문

BOOLEAN ExDeleteTimer(
  [in] PEX_TIMER              Timer,
  [in] BOOLEAN                Cancel,
  [in] BOOLEAN                Wait,
  [in] PEXT_DELETE_PARAMETERS Parameters
);

매개 변수

[in] Timer

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

[in] Cancel

타이머가 현재 설정된 경우 취소할지 여부입니다. TRUE이면 타이머가 설정된 경우 루틴이 타이머를 취소합니다. FALSE이면 루틴이 설정된 경우 타이머를 취소하지 않습니다. 호출자가 대기를 TRUE로 설정하면 취소도 TRUE여야 합니다. 그렇지 않으면 버그 검사 발생합니다.

[in] Wait

타이머가 이미 만료 프로세스를 시작한 경우 타이머가 만료될 때까지 기다릴지 여부입니다. TRUE이면 루틴은 타이머가 만료되기를 기다립니다. FALSE이면 루틴이 기다리지 않습니다. 자세한 내용은 설명 부분을 참조하세요.

[in] Parameters

EXT_DELETE_PARAMETERS 구조체에 대한 포인터입니다. 이전에 이 구조를 초기화 하기 위해 ExInitializeDeleteTimerParameters 루틴이라고 하는 호출 드라이버입니다.

반환 값

Cancel이 TRUE이고 타이머가 취소된 경우 이 루틴은 TRUE를 반환합니다. 그렇지 않으면 루틴이 FALSE를 반환 합니다. 자세한 내용은 설명 부분을 참조하세요.

설명

드라이버가 이 루틴을 호출하면 타이머 가 가리키는 타이머 개체가 더 이상 유효하지 않을 수 있습니다. 그러나 드라이버가 이 루틴을 구현하는 경우 ExTimerCallback 콜백 루틴에 전달된 타이머 매개 변수 값은 항상 타이머 개체에 대한 유효한 포인터입니다.

Cancel이 TRUE이면 FALSE 반환 값은 타이머가 설정되지 않았거나 타이머가 설정되었지만 취소되기 전에 만료되었음을 나타냅니다. Cancel이 FALSE이면 루틴은 항상 FALSE를 반환합니다.

Wait가 TRUE이면 이 루틴을 차단할 수 있습니다. DISPATCH_LEVEL 호출되는 드라이버의 ExTimerCallback 루틴에서 ExDeleteTimer가 호출되는 경우 이 호출의 Wait 매개 변수는 FALSE여야 합니다.

Wait가 TRUE이면 IRQL <= APC_LEVEL 루틴을 호출해야 합니다. Wait가 FALSE이면 IRQL <= DISPATCH_LEVEL 루틴을 호출할 수 있습니다.

자세한 내용은 System-Allocated 타이머 개체 삭제를 참조하세요.

요구 사항

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