다음을 통해 공유

PSS_CAPTURE_FLAGS 열거형(processsnapshot.h)

  • 아티클

PssCaptureSnapshot 캡처를 지정하는 플래그입니다.

Syntax

typedef enum {
  PSS_CAPTURE_NONE = 0x00000000,
  PSS_CAPTURE_VA_CLONE = 0x00000001,
  PSS_CAPTURE_RESERVED_00000002 = 0x00000002,
  PSS_CAPTURE_HANDLES = 0x00000004,
  PSS_CAPTURE_HANDLE_NAME_INFORMATION = 0x00000008,
  PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 0x00000010,
  PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 0x00000020,
  PSS_CAPTURE_HANDLE_TRACE = 0x00000040,
  PSS_CAPTURE_THREADS = 0x00000080,
  PSS_CAPTURE_THREAD_CONTEXT = 0x00000100,
  PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 0x00000200,
  PSS_CAPTURE_RESERVED_00000400 = 0x00000400,
  PSS_CAPTURE_VA_SPACE = 0x00000800,
  PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 0x00001000,
  PSS_CAPTURE_IPT_TRACE = 0x00002000,
  PSS_CAPTURE_RESERVED_00004000,
  PSS_CREATE_BREAKAWAY_OPTIONAL = 0x04000000,
  PSS_CREATE_BREAKAWAY = 0x08000000,
  PSS_CREATE_FORCE_BREAKAWAY = 0x10000000,
  PSS_CREATE_USE_VM_ALLOCATIONS = 0x20000000,
  PSS_CREATE_MEASURE_PERFORMANCE = 0x40000000,
  PSS_CREATE_RELEASE_SECTION = 0x80000000
} PSS_CAPTURE_FLAGS;

상수

 
PSS_CAPTURE_NONE
값: 0x00000000
아무 것도 캡처하지 않습니다.
PSS_CAPTURE_VA_CLONE
값: 0x00000001
프로세스에 있는 모든 복제 가능한 페이지의 스냅샷 캡처합니다. 복제본에는 공유 가능한 모든 섹션(MEM_MAPPED 및 MEM_IMAGE )뿐만 아니라 모든 MEM_PRIVATE 영역이 포함됩니다. CreateFileMapping을 통해 만든 모든 Win32 섹션을 공유할 수 있습니다.
PSS_CAPTURE_RESERVED_00000002
값: 0x00000002
(사용하지 마세요.)
PSS_CAPTURE_HANDLES
값: 0x00000004
핸들 테이블을 캡처합니다(핸들 값만 해당).
PSS_CAPTURE_HANDLE_NAME_INFORMATION
값: 0x00000008
각 핸들의 이름 정보를 캡처합니다.
PSS_CAPTURE_HANDLE_BASIC_INFORMATION
값: 0x00000010
HandleCount, PointerCount, GrantedAccess 등과 같은 기본 핸들 정보를 캡처합니다.
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION
값: 0x00000020
지원되는 개체 형식에 대한 형식별 정보 캡처: 프로세스, 스레드, 이벤트, 돌연변이, 섹션.
PSS_CAPTURE_HANDLE_TRACE
값: 0x00000040
핸들 추적 테이블을 캡처합니다.
PSS_CAPTURE_THREADS
값: 0x00000080
스레드 정보 캡처(ID만 해당).
PSS_CAPTURE_THREAD_CONTEXT
값: 0x00000100
각 스레드에 대한 컨텍스트를 캡처합니다.
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED
값: 0x00000200
각 스레드(예: CONTEXT_XSTATE)에 대한 확장 컨텍스트를 캡처합니다.
PSS_CAPTURE_RESERVED_00000400
값: 0x00000400
(사용하지 마세요.)
PSS_CAPTURE_VA_SPACE
값: 0x00000800
가상 주소 공간의 스냅샷 캡처합니다. VA 공간은 MEMORY_BASIC_INFORMATION 구조체의 배열로 캡처됩니다. 이 플래그는 페이지의 내용을 캡처하지 않습니다.
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION
값: 0x00001000
MEM_IMAGE 및 MEM_MAPPED 지역의 경우 섹션을 지원하는 파일의 경로를 덤프합니다(GetMappedFileName이 반환하는 것과 동일). MEM_IMAGE 지역의 경우 다음을 덤프합니다.



  • IMAGE_NT_HEADERS. FileHeader.TimeDateStamp



  • IMAGE_NT_HEADERS. OptionalHeader.SizeOfImage



  • IMAGE_NT_HEADERS. OptionalHeader.ImageBase



  • IMAGE_NT_HEADERS. OptionalHeader.CheckSum



프로세스 핸들에는 PROCESS_VM_READ 액세스 권한이 필요합니다.

경고 이 옵션은 PSS_CAPTURE_VA_SPACE 지정된 경우에만 유효합니다.

 
PSS_CAPTURE_IPT_TRACE
값: 0x00002000
PSS_CREATE_BREAKAWAY_OPTIONAL
값: 0x04000000
중단은 선택 사항입니다. 복제 프로세스가 중단으로 생성되지 않으면 작업 내부에 여전히 생성됩니다. 이 플래그는 PSS_CREATE_FORCE_BREAKAWAY 및/또는PSS_CREATE_BREAKAWAY 함께 지정해야 합니다.
PSS_CREATE_BREAKAWAY
값: 0x08000000
복제본이 부모 프로세스의 작업에서 분리됩니다. 이는 CreateProcess 플래그 CREATE_BREAKAWAY_FROM_JOB 동일합니다.
PSS_CREATE_FORCE_BREAKAWAY
값: 0x10000000
복제본은 부모 프로세스의 작업을 강제로 분리합니다. 이는 Tcb 권한 호출자에 대해서만 허용됩니다.
PSS_CREATE_USE_VM_ALLOCATIONS
값: 0x20000000
이 기능은 영구 또는 일시적인 할당에 프로세스 힙을 사용하면 안 됩니다. 예외 보고 경로(힙이 손상될 수 있음)에서 스냅샷 만들기와 같은 특정 컨텍스트에서 힙을 사용하는 것은 바람직하지 않을 수 있습니다.
PSS_CREATE_MEASURE_PERFORMANCE
값: 0x40000000
시설의 성능을 측정합니다. 성능 카운터는 PSS_QUERY_INFORMATION_CLASS PSS_QUERY_PERFORMANCE_COUNTERS 정보 클래스를 사용하여 PssQuerySnapshot을 통해 검색할 수 있습니다.
PSS_CREATE_RELEASE_SECTION
값: 0x80000000
VA(가상 주소) 복제 프로세스에는 기본 이미지에 대한 참조가 없습니다. 이로 인해 VA 복제 프로세스에서 QueryFullProcessImageName 과 같은 함수가 실패합니다.

중요  

PSS_CAPTURE_VA_CLONE 지정하지 않으면 이 플래그는 적용되지 않습니다.


 

설명

PSS_CREATE_FORCE_BREAKAWAY 및 PSS_CREATE_BREAKAWAY 모두 지정되면 PSS_CREATE_FORCE_BREAKAWAY 우선합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱만 해당]
머리글 processsnapshot.h

추가 정보

프로세스 스냅샷