OpenTraceFromRealTimeLoggerWithAllocationOptions 함수(evntrace.h)
활성 실시간 ETW 세션에 연결된 추적 처리 세션을 만듭니다.
구문
ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
PCWSTR LoggerName,
const ETW_OPEN_TRACE_OPTIONS *Options,
ULONG_PTR AllocationSize,
HANDLE MemoryPartitionHandle,
TRACE_LOGFILE_HEADER *LogFileHeader
);
매개 변수
LoggerName
실시간 이벤트 추적 세션의 이름 또는 로그 파일에서 데이터를 처리하는 경우 NULL 입니다. OpenTraceFromRealTimeLoggerWithAllocationOptions를 호출하여 실시간 세션의 데이터를 사용하는 경우 이 멤버의 값을 지정합니다.
OpenTraceFromRealTimeLoggerWithAllocationOptions를 호출할 때 LogFileHeader가 NULL이 아닌 경우 LoggerName은 NULL이어야 합니다.
추적 컨트롤러가 EVENT_TRACE_REAL_TIME_MODE 플래그를 포함하도록 EVENT_TRACE_PROPERTIESLogFileMode 멤버를 설정한 경우에만 이벤트를 실시간으로 사용할 수 있습니다.
관리자 권한이 있는 사용자, 성능 로그 사용자 그룹의 사용자 및 LocalSystem, LocalService, NetworkService로 실행되는 애플리케이션만 실시간으로 이벤트를 사용할 수 있습니다. 제한된 사용자에게 이벤트를 실시간으로 사용할 수 있는 기능을 부여하려면 이벤트를 성능 로그 사용자 그룹에 추가하거나 EventAccessControl을 호출합니다.
Options
이 처리 세션에 대한 구성 옵션입니다. 자세한 내용은 ETW_OPEN_TRACE_OPTIONS 참조하세요.
AllocationSize
처리 중에 ETW 버퍼를 저장하기 위해 미리 할당될 메모리의 크기(바이트)입니다. 할당이 클수록 일관된 메모리 사용량이 늘어나면 개별 할당/무료 호출의 필요성이 줄어듭니다. 이는 기본 Real-Time ETW 세션의 총 버퍼 공간 최소로 상향 조정되어 기본 작동에 충분한 용량이 할당되도록 합니다. 0이면 기본 크기가 사용됩니다.
MemoryPartitionHandle
이 처리 세션의 메모리 할당에 사용해야 하는 메모리 파티션에 대한 핸들입니다. NULL이면 프로세스의 메모리 파티션이 사용됩니다. 자세한 내용은 MemExtendedParameterPartitionHandle 을 참조하세요.
LogFileHeader
로그 파일에 대한 헤더 정보입니다. 자세한 내용은 TRACE_LOGFILE_HEADER 참조하세요.
반환 값
이 처리 세션을 식별하는 데 사용되는 TRACEHANDLE입니다. 일반적으로 처리를 시작하고 처리를 종료하기 위해 CloseTrace에 ProcessTrace에 전달됩니다.
설명
반환된 TRACEHANDLE에서 ProcessTrace가 호출되면 ETW 세션이 플러시될 때 버퍼를 수신하고 즉시 처리를 시작하고 옵션에 지정된 콜백을 호출합니다. 처리 세션에 대한 메모리 할당을 사용자 지정할 수 있다는 점을 제외하고 OpenTraceFromRealTime과 동일합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | evntrace.h |
라이브러리 | Windows 8.1 및 Windows Server 2012 R2의 Sechost.lib; Advapi32.lib on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP |
DLL | Windows 8.1 및 Windows Server 2012 R2의 Sechost.dll, Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista 및 Windows XP에서 Advapi32.dll |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기