EXT_DELETE_CALLBACK 콜백 함수(wdm.h)

  • 아티클

ExTimerDeleteCallback 콜백 루틴은 운영 체제에서 EX_TIMER 타이머 개체를 삭제할 때 실행됩니다.

구문

EXT_DELETE_CALLBACK ExtDeleteCallback;

void ExtDeleteCallback(
  [in, optional] PVOID Context
)
{...}

매개 변수

[in, optional] Context

드라이버가 이전에 ExDeleteTimer 루틴에 입력 매개 변수로 전달한 EXT_DELETE_PARAMETERS 구조체의 DeleteContext 멤버의 컨텍스트 값입니다.

반환 값

없음

설명

옵션으로 드라이버는 드라이버가 ExDeleteTimer 루틴에 입력 매개 변수로 전달하는 EXT_DELETE_PARAMETERS 구조체의 DeleteCallback 멤버에서 ExTimerDeleteCallback 루틴에 대한 포인터를 제공할 수 있습니다. ExTimerDeleteCallback 루틴은 삭제 중인 타이머 개체와 함께 사용하기 위해 드라이버가 이전에 할당했을 수 있는 스토리지 또는 기타 시스템 리소스를 해제할 수 있습니다.

드라이버가 ExTimerDeleteCallback 루틴을 제공하고 ExDeleteRoutine 호출의 Wait 매개 변수가 TRUE이면 ExDeleteTimer가 반환되기 전에 ExTimerDeleteCallback 루틴이 실행됩니다. 그렇지 않으면 ExTimerDeleteCallback 루틴이 ExDeleteTimer 호출이 반환되기 전이나 후에 실행될 수 있습니다. ExTimerDeleteCallback 루틴은 타이머 개체가 비활성화되어 추가 타이머 작업을 방지하고 타이머 개체의 보류 중인 타이머 작업이 취소되거나 완료된 후에만 호출됩니다. 드라이버가 ExDeleteTimer 루틴에 입력 매개 변수로 전달하는 타이머 개체(EX_TIMER 구조체)는 ExTimerDeleteCallback 루틴이 실행될 때까지 더 이상 유효하지 않을 수 있습니다.

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

예제

ExTimerDeleteCallback 콜백 루틴을 정의하려면 먼저 정의하려는 콜백 루틴의 유형을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 콜백 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾을 수 있으며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 라는 MyExTimerDeleteCallbackExTimerDeleteCallback 콜백 루틴을 정의하려면 다음 코드 예제와 같이 EXT_DELETE_CALLBACK 함수 형식을 사용합니다.

EXT_DELETE_CALLBACK  MyExTimerDeleteCallback;

그런 다음 다음과 같이 콜백 루틴을 구현합니다.

_Use_decl_annotations_
VOID
  MyExTimerDeleteCallback(
    PVOID  Context
    )
  {...}

EXT_DELETE_CALLBACK 함수 형식은 Wdm.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 _Use_decl_annotations_ 주석을 추가해야 합니다. 주석을 _Use_decl_annotations_ 사용하면 헤더 파일의 EXT_DELETE_CALLBACK 함수 형식에 적용되는 주석이 사용됩니다. 함수 선언에 대한 요구 사항에 대한 자세한 내용은 WDM 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요. 에 대한 _Use_decl_annotations_자세한 내용은 함수 동작 주석 지정을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 시작해서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
IRQL DISPATCH_LEVEL 호출합니다.

추가 정보

EXT_DELETE_PARAMETERS

EX_TIMER

ExDeleteTimer