피드백

EtwUnregister 함수(wdm.h)

  • 아티클
  • 읽는 데 2분 걸림

EtwUnregister 함수는 이벤트 공급자의 등록을 취소하고 공급자가 종료되기 전에 호출해야 합니다.

구문

NTSTATUS EtwUnregister(
  [in] REGHANDLE RegHandle
);

매개 변수

[in] RegHandle

이벤트 공급자 등록에 성공하면 EtwRegister 함수에서 반환되는 공급자 등록 핸들에 대한 포인터입니다.

반환 값

이벤트 공급자가 ETW로 등록 취소된 경우 EtwUnregister 함수는 STATUS_SUCCESS 상태 코드를 반환합니다.

설명

추적이 완료되면 드라이버는 EtwUnregister 함수를 호출하여 공급자를 등록 취소해야 합니다. EtwRegister에 대한 모든 호출에 대해 EtwUnregister에 해당하는 호출이 있어야 합니다. 이벤트 공급자의 등록을 취소하지 않으면 프로세스와 연결된 콜백이 더 이상 유효하지 않으므로 프로세스가 언로드될 때 오류가 발생할 수 있습니다. EtwRegister 및 EtwUnregister 함수에 의해 바인딩된 코드 외부에 있는 추적 호출은 만들어서는 안 됩니다. 최상의 성능을 위해 DriverEntry 루틴에서 EtwRegister 함수를 호출하고 DriverUnload 루틴에서 EtwUnregister 함수를 호출할 수 있습니다.

EtwRegister의 호출자는 시스템 스레드의 컨텍스트에서 IRQL = PASSIVE_LEVEL 실행되어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

참고 항목

EtwRegister