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 포함) |