다음을 통해 공유


ETWENABLECALLBACK 콜백 함수(wdm.h)

EtwEnableCallback 함수는 알림을 사용하거나 사용하지 않도록 설정하는 데 사용되는 선택적 드라이버 제공 콜백 함수입니다.

구문

ETWENABLECALLBACK Etwenablecallback;

void Etwenablecallback(
  [in]                LPCGUID SourceId,
                      ULONG ControlCode,
  [in]                UCHAR Level,
  [in]                ULONGLONG MatchAnyKeyword,
  [in]                ULONGLONG MatchAllKeyword,
  [in, optional]      PEVENT_FILTER_DESCRIPTOR FilterData,
  [in, out, optional] PVOID CallbackContext
)
{...}

매개 변수

[in] SourceId

공급자를 사용하도록 설정한 세션을 식별하는 GUID입니다.

ControlCode

[in] Level

이벤트가 사용되는 수준입니다. 이 매개 변수는 공급자가 작성하는 이벤트의 세부 정보를 지정하는 공급자 정의 값입니다. 이 값이 이벤트가 정의하는 수준 값보다 작거나 같은 경우 공급자는 이벤트를 작성해야 합니다.

이 값은 EnableTraceEx 함수의 Level 매개 변수 또는 EnableTrace 함수의 EnableLevel 매개 변수에 전달됩니다.

[in] MatchAnyKeyword

공급자가 작성하는 이벤트의 범주를 결정하는 데 사용하는 키워드의 비트 마스크입니다.

이 값은 EnableTraceEx 함수의 MatchAnyKeyword 매개 변수 또는 EnableTrace 함수의 EnableFlag 매개 변수에 전달됩니다. MatchAnyKeyword 는 64비트 값이며 기본적으로 32비트 EnableFlag의 확장 버전입니다.

[in] MatchAllKeyword

이 비트 마스크는 공급자가 작성하는 이벤트의 범주를 추가로 제한합니다.

이 값은 EnableTraceEx 함수의 MatchAllKeywords 매개 변수에 전달됩니다.

[in, optional] FilterData

공급자 정의 데이터입니다. 이 매개 변수는 선택적 요소입니다. 공급자는 데이터의 레이아웃과 용도를 결정합니다. 예를 들어 공급자는 이 데이터를 사용하여 기록되는 이벤트를 추가로 필터링하거나 이벤트를 작성하기 전에 계산을 수행하는 데 사용할 수 있습니다. 자세한 내용은 이벤트 필터 설명자를 참조하세요.

[in, out, optional] CallbackContext

공급자가 EtwRegister 를 호출하여 등록할 때 정의된 콜백 함수의 컨텍스트입니다. 이 매개 변수는 선택적 요소입니다.

반환 값

없음

설명

EtwRegister 함수를 사용하여 EtwEnableCallback 함수에 대한 포인터를 지정합니다.

콜백 함수의 FilterData 매개 변수를 사용하여 공급자에게 정교한 필터링 기능을 제공합니다. EtwEnableCallback 함수는 enable-상태 함수 호출(EtwEventEnabledEtwProviderEnabled)을 대체하지 않습니다. 그러나, 그것은 그들에 대 한 보충 역할을. 그러나 수준 및 키워드를 현재 사용하도록 설정하지 않으면 콜백 함수가 제공하는 FilterData 에 관계없이 이벤트가 작성되지 않습니다.

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

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 wdm.h(Wdm.h, Ntddk.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

이벤트 필터 설명자