RECORDER_LOG_CREATE_PARAMS 구조체(wpprecorder.h)

RECORDER_LOG_CREATE_PARAMS 구조체는 WppRecorderLogCreate 메서드에 대한 입력 매개 변수입니다.

구문

typedef struct _RECORDER_LOG_CREATE_PARAMS {
  ULONG                  Size;
  ULONG                  LogTag;
  ULONG                  TotalBufferSize;
  ULONG                  ErrorPartitionSize;
  ULONG_PTR              LogIdentifierAppendValue;
  BOOLEAN                LogIdentifierAppendValueSet;
  ULONG                  LogIdentifierSize;
  CHAR                   LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS];
  WPP_RECORDER_TRI_STATE UseTimeStamp;
  WPP_RECORDER_TRI_STATE PreciseTimeStamp;
} RECORDER_LOG_CREATE_PARAMS, *PRECORDER_LOG_CREATE_PARAMS;

멤버

Size

이 구조체의 크기입니다.

LogTag

로그의 할당된 메모리와 연결할 선택적 태그입니다.

TotalBufferSize

로그 영역의 크기(바이트)입니다.

ErrorPartitionSize

오류 메시지를 기록하는 데 사용되는 TotalBufferSize 의 바이트 수입니다. 0은 오류 파티션이 없음을 나타냅니다.

LogIdentifierAppendValue

로그 식별자에 추가할 숫자/포인터입니다.

LogIdentifierAppendValueSet

LogIdentifierAppendValue가 설정되었는지 여부를 지정합니다.

LogIdentifierSize

클라이언트 정의에 따라 LogIdentifier 필드의 크기(바이트)입니다.

LogIdentifier[RECORDER_LOG_IDENTIFIER_MAX_CHARS]

디버그 메시지가 병합되면 인쇄할 식별자입니다. 어떤 시점에서 클라이언트가 배열 크기에 대한 정의가 다른 경우 구조체의 나머지 부분을 읽는 것이 간단하게 유지되도록 구조의 끝에 있습니다.

UseTimeStamp

다음을 나타내는 WPP_RECORDER_TRI_STATE 형식의 값입니다.

• WppRecorderTrue로 설정하면 밀리초 단위의 타임스탬프가 WPP 로그 항목에 추가됩니다.
• WppRecorderFalse로 설정하면 타임스탬프가 기록되지 않습니다.
• WppRecorderDefault로 설정된 경우 드라이버 패키지의 INF 파일이 WppRecorder_UseTimeStamp 1로 설정하지 않는 한 WppRecorderFalse와 동일한 효과가 있습니다. 이 경우 WppRecorderTrue를 의미합니다.

이 필드는 Windows 11 버전 22H2부터 사용할 수 있습니다. 자세한 내용은 추적 로깅에 대한 IFR(Inflight Trace Recorder)을 참조하세요.

PreciseTimeStamp

다음을 나타내는 WPP_RECORDER_TRI_STATE 형식의 값입니다.

• WppRecorderTrue로 설정하면 마이크로초 세분성의 10분의 1 타임스탬프가 WPP 로그 항목에 추가됩니다.
• WppRecorderFalse로 설정하면 타임스탬프가 기록되지 않습니다.
• WppRecorderDefault로 설정하면 드라이버 패키지의 INF 파일이 WppRecorder_UseTimeStamp 설정하고 WppRecorder_PreciseTimeStamp 1로 설정하지 않는 한 WppRecorderFalse와 동일한 효과가 있습니다. 이 경우 WppRecorderTrue를 의미합니다.

이 필드는 Windows 11 버전 22H2부터 사용할 수 있습니다. 자세한 내용은 추적 로깅에 대한 IFR(Inflight Trace Recorder)을 참조하세요.

요구 사항

요구 사항	값
헤더	wpprecorder.h

추가 정보

RECORDER_LOG_CREATE_PARAMS_INIT