ExDeleteTimer 함수(wdm.h)
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 경우 루틴이 설정된 경우 타이머를 취소하지 않습니다. 호출자가 Wait TRUE 설정하면 취소 true 합니다. 그렇지 않으면 버그 검사가 발생합니다.
[in] Wait
타이머가 이미 만료 프로세스를 시작한 경우 타이머가 만료될 때까지 기다릴지 여부입니다. TRUE 경우 루틴은 타이머가 만료되기를 기다립니다. FALSE 경우 루틴은 기다리지 않습니다. 자세한 내용은 비고를 참조하세요.
[in] Parameters
EXT_DELETE_PARAMETERS 구조체에 대한 포인터입니다. 이전에 ExInitializeDeleteTimerParameters라는 호출 드라이버는 이 구조를 초기화하는 루틴을.
반환 값
이 루틴은 취소 TRUE 타이머가 취소된 경우 TRUE 반환합니다. 그렇지 않으면 루틴은 FALSE 반환합니다. 자세한 내용은 비고를 참조하세요.
발언
드라이버가 이 루틴을 호출하면 타이머 가리키는 타이머 개체가 더 이상 유효하지 않을 수 있습니다. 그러나 드라이버가 이 루틴을 구현하는 경우 ExTimerCallback 콜백 루틴에 전달된 타이머 매개 변수 값은 항상 타이머 개체에 대한 유효한 포인터입니다.
취소 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 | 비고를 참조하세요. |