WmiQueryTraceInformation 함수(wdm.h)

  • 아티클

WmiQueryTraceInformation 루틴은 WMI 이벤트 추적대한 정보를 반환합니다.

통사론

NTSTATUS WmiQueryTraceInformation(
  [in]            TRACE_INFORMATION_CLASS TraceInformationClass,
  [out]           PVOID                   TraceInformation,
  [in]            ULONG                   TraceInformationLength,
  [out, optional] PULONG                  RequiredLength,
  [in, optional]  PVOID                   Buffer
);

매개 변수

[in] TraceInformationClass

이벤트 추적에 대해 반환할 정보의 형식을 나타내는 TRACE_INFORMATION_CLASS 열거자를 지정합니다.

[out] TraceInformation

루틴이 TraceInformationClass지정된 이벤트 추적 정보를 반환하는 호출자 할당 출력 버퍼에 대한 포인터입니다.

[in] TraceInformationLength

TraceInformation 버퍼의 크기(바이트)를 지정합니다.

[out, optional] RequiredLength

TraceInformation 버퍼의 필요한 크기(바이트)를 지정하는 루틴에서 반환되는 값에 대한 포인터입니다. 호출자는 필요한 길이 정보를 사용하지 않는 경우 RequiredLength NULL 설정해야 합니다.

[in, optional] Buffer

호출자가 제공하는 쿼리별 입력 정보에 대한 포인터입니다. 호출자가 제공한 정보가 필요하지 않은 경우 호출자는 Buffer NULL설정해야 합니다.

반환 값

반환 코드 묘사
STATUS_SUCCESS
 성공
STATUS_INFO_LENGTH_MISMATCH
 TraceInformation 버퍼의 크기가 지정된 이벤트 추적 정보에 필요한 크기와 같지 않습니다.
STATUS_INVALID_HANDLE
 (PWNODE_HEADER)BufferHistoricalContext 멤버가 지정한 추적 핸들이 잘못되었습니다.
STATUS_INVALID_INFO_CLASS
 지정된 유형의 이벤트 추적 정보가 잘못되었습니다.
STATUS_INVALID_PARAMETER
 이름이 지정된 경우 추적 핸들을 반환하는 쿼리와 함께 제공된 이벤트 추적의 이름이 잘못되었습니다.
STATUS_INVALID_PARAMETER_MIX
 호출자가 지정된 이벤트 추적 정보에 필요한 정보를 제공하지 않았습니다.
STATUS_MORE_ENTRIES
 TraceInformation 버퍼는 유효한 모든 이벤트 추적 핸들의 배열을 저장할 만큼 크지 않습니다.
STATUS_NOT_FOUND
 전역 로거를 찾을 수 없습니다.

발언

TraceInformationClass지정된 각 유형의 이벤트 추적 정보에 대해 다음 표를 제공합니다.

  • 입력 요구 사항
  • WmiQueryTraceInformation TraceInformation 버퍼에서 반환하는 정보
TraceClassInformation 값 입력 요구 사항 반환된 정보
TraceIdClass TraceInformationLength ULONG(sizeof) 값과 같습니다.

TraceInformation 버퍼의 크기(바이트)가 ULONG(sizeof)의 값보다 크거나 같습니다.

Buffer PWNODE_HEADER HistoricalContext 멤버는 이벤트 추적 핸들을 지정합니다.

 *(PULONG)TraceInformation 이벤트 추적 핸들의 로거 ID로 설정됩니다.
traceHandleClass TraceInformationLength(TRACEHANDLE)의 sizeof 값과 같습니다.

TraceInformation 버퍼의 크기(바이트)는 sizeof(TRACEHANDLE)의 값보다 크거나 같아야 합니다.

*(PULONG)버퍼 로거 ID로 설정됩니다.

 *(PTRACEHANDLE)TraceInformation 지정된 로거에 대한 이벤트 추적 핸들로 설정됩니다. 지정된 로거 ID가 0이면 커널 로거에 대한 이벤트 추적 핸들이 반환됩니다.
TraceEnableFlagsClass TraceInformationLength ULONG(sizeof) 값보다 크거나 같습니다.

TraceInformation 버퍼의 크기(바이트)는 ULONG(sizeof)의 값보다 크거나 같아야 합니다.

Buffer PWNODE_HEADER HistoricalContext 멤버는 이벤트 추적 핸들을 지정합니다.

 *(PULONG)TraceInformation 지정된 이벤트 추적 핸들에 대해 설정된 사용 플래그로 설정됩니다.
TraceEnableLevelClass TraceInformationLength ULONG(sizeof) 값보다 크거나 같게 설정됩니다.

TraceInformation 버퍼의 크기(바이트)는 ULONG(sizeof)의 값보다 크거나 같아야 합니다.

Buffer PWNODE_HEADER HistoricalContext 멤버는 이벤트 추적 핸들을 지정합니다.

 *(PULONG)TraceInformation 지정된 이벤트 추적 핸들의 수준으로 설정됩니다.
GlobalLoggerHandleClass TraceInformationLength(TRACEHANDLE)의 sizeof 값과 같습니다.

TraceInformation 버퍼의 크기(바이트)는 sizeof(TRACEHANDLE)의 값보다 크거나 같아야 합니다.

 *(PTRACEHANDLE)TraceInformation 전역 로거에 대한 이벤트 추적 핸들로 설정됩니다.
eventLoggerHandleClass 내부 전용입니다. 내부 전용입니다.
AllLoggerHandlesClass TraceInformationLengthm TRACEHANDLE 값 배열의 크기(바이트)로 설정됩니다.

TraceInformation 버퍼의 크기(바이트)는 (m*sizeof(TRACEHANDLE))의 값보다 크거나 같아야 합니다.

 TraceInformation 버퍼에는 n개의 추적 핸들 배열이 포함되어 있습니다. 여기서 n 최소 m, 호출자가 제공한 이벤트 추적 핸들 수 및 유효한 이벤트 추적 핸들의 수입니다. 루틴은 TraceInformation 버퍼가 너무 작아서 모든 추적 핸들을 보유하지 못하는 경우 STATUS_MORE_ENTRIES 상태를 반환합니다.
TraceHandleByNameClass TraceInformationLengthsizeof(TRACEHANDLE)의 값으로 설정됩니다.

TraceInformation 버퍼의 크기(바이트)는 sizeof(TRACEHANDLE)의 값보다 크거나 같아야 합니다.

(PUNICODE_STRING)버퍼 유니코드 형식의 친숙한 추적 이름을 지정합니다.

 *(PTRACEHANDLE)TraceInformation 지정된 이름에 연결된 이벤트 추적 핸들로 설정됩니다.
 

호출자가NULLRequiredLength 포인터를 제공하는 경우 WmiQueryTraceInformation 지정된 이벤트 추적 정보에 필요한 길이도 반환합니다.

WmiQueryTraceInformation 호출자의 IRQL에서 실행됩니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 보편적
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 설명 섹션을 참조하세요.

참고 항목

IoWmiWriteEvent

TRACE_INFORMATION_CLASS

WmiFireEvent

WmiTraceMessage

WmiTraceMessageVa