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-status 함수 호출(EtwEventEnabled 및 EtwProviderEnabled)을 대체하지 않습니다. 그러나, 그것은 그들에 대 한 보충 역할을. 그러나 수준 및 키워드를 현재 사용하도록 설정하지 않으면 콜백 함수가 제공하는 FilterData 관계없이 이벤트가 기록되지 않습니다.

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	바탕 화면
헤더	wdm.h(Wdm.h, Ntddk.h 포함)
IRQL	PASSIVE_LEVEL