EXT_DELETE_PARAMETERS 구조체(wdm.h)

  • 아티클

EXT_DELETE_PARAMETERS 구조체에는 ExDeleteTimer 루틴에 대한 확장된 매개 변수 집합이 포함되어 있습니다.

구문

typedef struct _EXT_DELETE_PARAMETERS {
  ULONG                Version;
  ULONG                Reserved;
  PEXT_DELETE_CALLBACK DeleteCallback;
  PVOID                DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;

멤버

Version

이 EXT_DELETE_PARAMETERS 구조체의 버전 번호입니다. ExInitializeDeleteTimerParameters 루틴은 이 멤버를 올바른 버전 번호로 설정합니다.

Reserved

0으로 설정됩니다. ExInitializeDeleteTimerParameters 루틴은 이 멤버를 0으로 설정합니다.

DeleteCallback

드라이버 구현 ExTimerDeleteCallback 콜백 루틴에 대한 포인터입니다. 운영 체제는 타이머가 삭제되면 이 루틴을 호출합니다. 이 매개 변수는 선택 사항이며 타이머 삭제 콜백 루틴이 필요하지 않은 경우 NULL 일 수 있습니다.

ExInitializeDeleteTimerParameters 루틴은 이 멤버를 NULL로 설정합니다. 자세한 내용은 설명 부분을 참조하세요.

DeleteContext

타이머 삭제 콜백 루틴에 대한 컨텍스트 값입니다. 운영 체제는 지정된 경우 이 값을 타이머 삭제 콜백 루틴에 매개 변수로 전달합니다. 이 매개 변수는 일반적으로 콜백 루틴에서 사용하는 컨텍스트 정보를 포함하는 호출자 정의 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 컨텍스트 정보가 필요하지 않은 경우 NULL 로 설정할 수 있습니다.

ExInitializeDeleteTimerParameters 루틴은 이 멤버를 NULL로 설정합니다.

설명

ExDeleteTimer 루틴의 Parameters 매개 변수는 EXT_DELETE_PARAMETERS 구조체에 대한 포인터입니다. 이 루틴에 EXT_DELETE_PARAMETERS 구조를 전달하기 전에 ExInitializeDeleteTimerParameters 루틴을 호출하여 구조를 초기화합니다.

드라이버는 ExTimerDeleteCallback 콜백 루틴을 사용하여 삭제되는 타이머 개체와 함께 사용하기 위해 드라이버가 이전에 할당했을 수 있는 스토리지 또는 기타 시스템 리소스를 해제할 수 있습니다. 예를 들어 드라이버의 컨텍스트 값은 타이머 개체를 삭제할 경우 해제해야 하는 호출자 할당 구조를 가리킬 수 있습니다. 운영 체제는 타이머 개체를 사용하지 않도록 설정한 후에만 ExTimerDeleteCallback 루틴을 호출하여 추가 타이머 작업을 방지하고 타이머 개체에 대한 보류 중인 타이머 작업이 취소되거나 완료됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 부터 지원합니다.
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

추가 정보

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback