Win32 API 日本語リファレンス
ホーム › System.Diagnostics.ProcessSnapshotting › PSS_CAPTURE_FLAGS

PSS_CAPTURE_FLAGS

列挙型フラグ
📘 Microsoft Learn (日本語) · English
基底型u4

メンバー 22

名前10進16進説明
PSS_CAPTURE_NONE00x0何もキャプチャーしません。
PSS_CAPTURE_VA_CLONE10x1プロセス内のクローン可能なすべてのページのスナップショットをキャプチャーします。クローンには、すべての MEM_PRIVATE 領域と、共有可能なすべてのセクション (MEM_MAPPED および MEM_IMAGE) が含まれます。CreateFileMapping で作成された Win32 セクションはすべて共有可能です。
PSS_CAPTURE_RESERVED_0000000220x2(使用しないでください。)
PSS_CAPTURE_HANDLES40x4ハンドルテーブルをキャプチャーします (ハンドル値のみ)。
PSS_CAPTURE_HANDLE_NAME_INFORMATION80x8各ハンドルの名前情報をキャプチャーします。
PSS_CAPTURE_HANDLE_BASIC_INFORMATION160x10HandleCount、PointerCount、GrantedAccess などの基本的なハンドル情報をキャプチャーします。
PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION320x20サポートされているオブジェクトの種類 (Process、Thread、Event、Mutant、Section.) について、種類固有の情報をキャプチャーします。
PSS_CAPTURE_HANDLE_TRACE640x40ハンドルトレーステーブルをキャプチャーします。
PSS_CAPTURE_THREADS1280x80スレッド情報 (ID のみ) をキャプチャーします。
PSS_CAPTURE_THREAD_CONTEXT2560x100各スレッドのコンテキストをキャプチャーします。
PSS_CAPTURE_THREAD_CONTEXT_EXTENDED5120x200各スレッドの拡張コンテキスト (CONTEXT_XSTATE など) をキャプチャーします。
PSS_CAPTURE_RESERVED_0000040010240x400(使用しないでください。)
PSS_CAPTURE_VA_SPACE20480x800仮想アドレス空間のスナップショットをキャプチャーします。VA 空間は MEMORY_BASIC_INFORMATION 構造体の配列としてキャプチャーされます。このフラグではページの内容はキャプチャーされません。
PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION40960x1000

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 アクセス権が必要です。
Warning このオプションは PSS_CAPTURE_VA_SPACE が指定されている場合にのみ有効です。
PSS_CAPTURE_IPT_TRACE81920x2000
PSS_CAPTURE_RESERVED_00004000163840x4000
PSS_CREATE_BREAKAWAY_OPTIONAL671088640x4000000ブレークアウェイは省略可能です。クローンプロセスをブレークアウェイとして作成できなかった場合、そのプロセスはジョブ内に残ったまま作成されます。このフラグは PSS_CREATE_FORCE_BREAKAWAY または PSS_CREATE_BREAKAWAY、あるいはその両方と組み合わせて指定しなければなりません。
PSS_CREATE_BREAKAWAY1342177280x8000000クローンを親プロセスのジョブから分離します。これは CreateProcess のフラグ CREATE_BREAKAWAY_FROM_JOB と同等です。
PSS_CREATE_FORCE_BREAKAWAY2684354560x10000000クローンを親プロセスのジョブから強制的に分離します。これは Tcb 特権を持つ呼び出し元にのみ許可されます。
PSS_CREATE_USE_VM_ALLOCATIONS5368709120x20000000永続的な割り当てにも一時的な割り当てにも、この機能がプロセスヒープを使用しないようにします。例外報告のパスでスナップショットを作成する場合 (ヒープが破損している可能性がある場合) など、特定の状況ではヒープの使用が望ましくないことがあります。
PSS_CREATE_MEASURE_PERFORMANCE10737418240x40000000この機能のパフォーマンスを測定します。パフォーマンスカウンターは、PSS_QUERY_INFORMATION_CLASS の PSS_QUERY_PERFORMANCE_COUNTERS 情報クラスを指定して PssQuerySnapshot を呼び出すことで取得できます。
PSS_CREATE_RELEASE_SECTION21474836480x80000000

仮想アドレス (VA) のクローンプロセスが、基になるイメージへの参照を保持しません。このため、VA クローンプロセスに対して QueryFullProcessImageName などの関数が失敗するようになります。

Important

このフラグは PSS_CAPTURE_VA_CLONE が指定されていない限り効果がありません。

公式ドキュメント

PssCaptureSnapshot が何をキャプチャーするかを指定するフラグです。

解説(Remarks)

PSS_CREATE_FORCE_BREAKAWAY と PSS_CREATE_BREAKAWAY の両方が指定されている場合は、PSS_CREATE_FORCE_BREAKAWAY が優先されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum PSS_CAPTURE_FLAGS : unsigned int {
    PSS_CAPTURE_NONE = 0,
    PSS_CAPTURE_VA_CLONE = 1,
    PSS_CAPTURE_RESERVED_00000002 = 2,
    PSS_CAPTURE_HANDLES = 4,
    PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8,
    PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16,
    PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32,
    PSS_CAPTURE_HANDLE_TRACE = 64,
    PSS_CAPTURE_THREADS = 128,
    PSS_CAPTURE_THREAD_CONTEXT = 256,
    PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512,
    PSS_CAPTURE_RESERVED_00000400 = 1024,
    PSS_CAPTURE_VA_SPACE = 2048,
    PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096,
    PSS_CAPTURE_IPT_TRACE = 8192,
    PSS_CAPTURE_RESERVED_00004000 = 16384,
    PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864,
    PSS_CREATE_BREAKAWAY = 134217728,
    PSS_CREATE_FORCE_BREAKAWAY = 268435456,
    PSS_CREATE_USE_VM_ALLOCATIONS = 536870912,
    PSS_CREATE_MEASURE_PERFORMANCE = 1073741824,
    PSS_CREATE_RELEASE_SECTION = 2147483648
} PSS_CAPTURE_FLAGS;
[Flags]
public enum PSS_CAPTURE_FLAGS : uint
{
    PSS_CAPTURE_NONE = 0,
    PSS_CAPTURE_VA_CLONE = 1,
    PSS_CAPTURE_RESERVED_00000002 = 2,
    PSS_CAPTURE_HANDLES = 4,
    PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8,
    PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16,
    PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32,
    PSS_CAPTURE_HANDLE_TRACE = 64,
    PSS_CAPTURE_THREADS = 128,
    PSS_CAPTURE_THREAD_CONTEXT = 256,
    PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512,
    PSS_CAPTURE_RESERVED_00000400 = 1024,
    PSS_CAPTURE_VA_SPACE = 2048,
    PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096,
    PSS_CAPTURE_IPT_TRACE = 8192,
    PSS_CAPTURE_RESERVED_00004000 = 16384,
    PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864,
    PSS_CREATE_BREAKAWAY = 134217728,
    PSS_CREATE_FORCE_BREAKAWAY = 268435456,
    PSS_CREATE_USE_VM_ALLOCATIONS = 536870912,
    PSS_CREATE_MEASURE_PERFORMANCE = 1073741824,
    PSS_CREATE_RELEASE_SECTION = 2147483648,
}
<Flags>
Public Enum PSS_CAPTURE_FLAGS As UInteger
    PSS_CAPTURE_NONE = 0
    PSS_CAPTURE_VA_CLONE = 1
    PSS_CAPTURE_RESERVED_00000002 = 2
    PSS_CAPTURE_HANDLES = 4
    PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8
    PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16
    PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32
    PSS_CAPTURE_HANDLE_TRACE = 64
    PSS_CAPTURE_THREADS = 128
    PSS_CAPTURE_THREAD_CONTEXT = 256
    PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512
    PSS_CAPTURE_RESERVED_00000400 = 1024
    PSS_CAPTURE_VA_SPACE = 2048
    PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096
    PSS_CAPTURE_IPT_TRACE = 8192
    PSS_CAPTURE_RESERVED_00004000 = 16384
    PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864
    PSS_CREATE_BREAKAWAY = 134217728
    PSS_CREATE_FORCE_BREAKAWAY = 268435456
    PSS_CREATE_USE_VM_ALLOCATIONS = 536870912
    PSS_CREATE_MEASURE_PERFORMANCE = 1073741824
    PSS_CREATE_RELEASE_SECTION = 2147483648
End Enum
import enum

class PSS_CAPTURE_FLAGS(enum.IntFlag):
    PSS_CAPTURE_NONE = 0
    PSS_CAPTURE_VA_CLONE = 1
    PSS_CAPTURE_RESERVED_00000002 = 2
    PSS_CAPTURE_HANDLES = 4
    PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8
    PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16
    PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32
    PSS_CAPTURE_HANDLE_TRACE = 64
    PSS_CAPTURE_THREADS = 128
    PSS_CAPTURE_THREAD_CONTEXT = 256
    PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512
    PSS_CAPTURE_RESERVED_00000400 = 1024
    PSS_CAPTURE_VA_SPACE = 2048
    PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096
    PSS_CAPTURE_IPT_TRACE = 8192
    PSS_CAPTURE_RESERVED_00004000 = 16384
    PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864
    PSS_CREATE_BREAKAWAY = 134217728
    PSS_CREATE_FORCE_BREAKAWAY = 268435456
    PSS_CREATE_USE_VM_ALLOCATIONS = 536870912
    PSS_CREATE_MEASURE_PERFORMANCE = 1073741824
    PSS_CREATE_RELEASE_SECTION = 2147483648
// PSS_CAPTURE_FLAGS (flags)
pub const PSS_CAPTURE_NONE: u32 = 0;
pub const PSS_CAPTURE_VA_CLONE: u32 = 1;
pub const PSS_CAPTURE_RESERVED_00000002: u32 = 2;
pub const PSS_CAPTURE_HANDLES: u32 = 4;
pub const PSS_CAPTURE_HANDLE_NAME_INFORMATION: u32 = 8;
pub const PSS_CAPTURE_HANDLE_BASIC_INFORMATION: u32 = 16;
pub const PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION: u32 = 32;
pub const PSS_CAPTURE_HANDLE_TRACE: u32 = 64;
pub const PSS_CAPTURE_THREADS: u32 = 128;
pub const PSS_CAPTURE_THREAD_CONTEXT: u32 = 256;
pub const PSS_CAPTURE_THREAD_CONTEXT_EXTENDED: u32 = 512;
pub const PSS_CAPTURE_RESERVED_00000400: u32 = 1024;
pub const PSS_CAPTURE_VA_SPACE: u32 = 2048;
pub const PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION: u32 = 4096;
pub const PSS_CAPTURE_IPT_TRACE: u32 = 8192;
pub const PSS_CAPTURE_RESERVED_00004000: u32 = 16384;
pub const PSS_CREATE_BREAKAWAY_OPTIONAL: u32 = 67108864;
pub const PSS_CREATE_BREAKAWAY: u32 = 134217728;
pub const PSS_CREATE_FORCE_BREAKAWAY: u32 = 268435456;
pub const PSS_CREATE_USE_VM_ALLOCATIONS: u32 = 536870912;
pub const PSS_CREATE_MEASURE_PERFORMANCE: u32 = 1073741824;
pub const PSS_CREATE_RELEASE_SECTION: u32 = 2147483648;
// PSS_CAPTURE_FLAGS
const (
	PSS_CAPTURE_NONE uint32 = 0
	PSS_CAPTURE_VA_CLONE uint32 = 1
	PSS_CAPTURE_RESERVED_00000002 uint32 = 2
	PSS_CAPTURE_HANDLES uint32 = 4
	PSS_CAPTURE_HANDLE_NAME_INFORMATION uint32 = 8
	PSS_CAPTURE_HANDLE_BASIC_INFORMATION uint32 = 16
	PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION uint32 = 32
	PSS_CAPTURE_HANDLE_TRACE uint32 = 64
	PSS_CAPTURE_THREADS uint32 = 128
	PSS_CAPTURE_THREAD_CONTEXT uint32 = 256
	PSS_CAPTURE_THREAD_CONTEXT_EXTENDED uint32 = 512
	PSS_CAPTURE_RESERVED_00000400 uint32 = 1024
	PSS_CAPTURE_VA_SPACE uint32 = 2048
	PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION uint32 = 4096
	PSS_CAPTURE_IPT_TRACE uint32 = 8192
	PSS_CAPTURE_RESERVED_00004000 uint32 = 16384
	PSS_CREATE_BREAKAWAY_OPTIONAL uint32 = 67108864
	PSS_CREATE_BREAKAWAY uint32 = 134217728
	PSS_CREATE_FORCE_BREAKAWAY uint32 = 268435456
	PSS_CREATE_USE_VM_ALLOCATIONS uint32 = 536870912
	PSS_CREATE_MEASURE_PERFORMANCE uint32 = 1073741824
	PSS_CREATE_RELEASE_SECTION uint32 = 2147483648
)
const
  PSS_CAPTURE_NONE = 0;
  PSS_CAPTURE_VA_CLONE = 1;
  PSS_CAPTURE_RESERVED_00000002 = 2;
  PSS_CAPTURE_HANDLES = 4;
  PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8;
  PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16;
  PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32;
  PSS_CAPTURE_HANDLE_TRACE = 64;
  PSS_CAPTURE_THREADS = 128;
  PSS_CAPTURE_THREAD_CONTEXT = 256;
  PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512;
  PSS_CAPTURE_RESERVED_00000400 = 1024;
  PSS_CAPTURE_VA_SPACE = 2048;
  PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096;
  PSS_CAPTURE_IPT_TRACE = 8192;
  PSS_CAPTURE_RESERVED_00004000 = 16384;
  PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864;
  PSS_CREATE_BREAKAWAY = 134217728;
  PSS_CREATE_FORCE_BREAKAWAY = 268435456;
  PSS_CREATE_USE_VM_ALLOCATIONS = 536870912;
  PSS_CREATE_MEASURE_PERFORMANCE = 1073741824;
  PSS_CREATE_RELEASE_SECTION = 2147483648;
// PSS_CAPTURE_FLAGS
pub const PSS_CAPTURE_NONE: u32 = 0;
pub const PSS_CAPTURE_VA_CLONE: u32 = 1;
pub const PSS_CAPTURE_RESERVED_00000002: u32 = 2;
pub const PSS_CAPTURE_HANDLES: u32 = 4;
pub const PSS_CAPTURE_HANDLE_NAME_INFORMATION: u32 = 8;
pub const PSS_CAPTURE_HANDLE_BASIC_INFORMATION: u32 = 16;
pub const PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION: u32 = 32;
pub const PSS_CAPTURE_HANDLE_TRACE: u32 = 64;
pub const PSS_CAPTURE_THREADS: u32 = 128;
pub const PSS_CAPTURE_THREAD_CONTEXT: u32 = 256;
pub const PSS_CAPTURE_THREAD_CONTEXT_EXTENDED: u32 = 512;
pub const PSS_CAPTURE_RESERVED_00000400: u32 = 1024;
pub const PSS_CAPTURE_VA_SPACE: u32 = 2048;
pub const PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION: u32 = 4096;
pub const PSS_CAPTURE_IPT_TRACE: u32 = 8192;
pub const PSS_CAPTURE_RESERVED_00004000: u32 = 16384;
pub const PSS_CREATE_BREAKAWAY_OPTIONAL: u32 = 67108864;
pub const PSS_CREATE_BREAKAWAY: u32 = 134217728;
pub const PSS_CREATE_FORCE_BREAKAWAY: u32 = 268435456;
pub const PSS_CREATE_USE_VM_ALLOCATIONS: u32 = 536870912;
pub const PSS_CREATE_MEASURE_PERFORMANCE: u32 = 1073741824;
pub const PSS_CREATE_RELEASE_SECTION: u32 = 2147483648;
const
  PSS_CAPTURE_NONE* = 0
  PSS_CAPTURE_VA_CLONE* = 1
  PSS_CAPTURE_RESERVED_00000002* = 2
  PSS_CAPTURE_HANDLES* = 4
  PSS_CAPTURE_HANDLE_NAME_INFORMATION* = 8
  PSS_CAPTURE_HANDLE_BASIC_INFORMATION* = 16
  PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION* = 32
  PSS_CAPTURE_HANDLE_TRACE* = 64
  PSS_CAPTURE_THREADS* = 128
  PSS_CAPTURE_THREAD_CONTEXT* = 256
  PSS_CAPTURE_THREAD_CONTEXT_EXTENDED* = 512
  PSS_CAPTURE_RESERVED_00000400* = 1024
  PSS_CAPTURE_VA_SPACE* = 2048
  PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION* = 4096
  PSS_CAPTURE_IPT_TRACE* = 8192
  PSS_CAPTURE_RESERVED_00004000* = 16384
  PSS_CREATE_BREAKAWAY_OPTIONAL* = 67108864
  PSS_CREATE_BREAKAWAY* = 134217728
  PSS_CREATE_FORCE_BREAKAWAY* = 268435456
  PSS_CREATE_USE_VM_ALLOCATIONS* = 536870912
  PSS_CREATE_MEASURE_PERFORMANCE* = 1073741824
  PSS_CREATE_RELEASE_SECTION* = 2147483648
enum PSS_CAPTURE_FLAGS : uint {
    PSS_CAPTURE_NONE = 0,
    PSS_CAPTURE_VA_CLONE = 1,
    PSS_CAPTURE_RESERVED_00000002 = 2,
    PSS_CAPTURE_HANDLES = 4,
    PSS_CAPTURE_HANDLE_NAME_INFORMATION = 8,
    PSS_CAPTURE_HANDLE_BASIC_INFORMATION = 16,
    PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION = 32,
    PSS_CAPTURE_HANDLE_TRACE = 64,
    PSS_CAPTURE_THREADS = 128,
    PSS_CAPTURE_THREAD_CONTEXT = 256,
    PSS_CAPTURE_THREAD_CONTEXT_EXTENDED = 512,
    PSS_CAPTURE_RESERVED_00000400 = 1024,
    PSS_CAPTURE_VA_SPACE = 2048,
    PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION = 4096,
    PSS_CAPTURE_IPT_TRACE = 8192,
    PSS_CAPTURE_RESERVED_00004000 = 16384,
    PSS_CREATE_BREAKAWAY_OPTIONAL = 67108864,
    PSS_CREATE_BREAKAWAY = 134217728,
    PSS_CREATE_FORCE_BREAKAWAY = 268435456,
    PSS_CREATE_USE_VM_ALLOCATIONS = 536870912,
    PSS_CREATE_MEASURE_PERFORMANCE = 1073741824,
    PSS_CREATE_RELEASE_SECTION = 2147483648,
}
#define global PSS_CAPTURE_NONE                             0x0
#define global PSS_CAPTURE_VA_CLONE                         0x1
#define global PSS_CAPTURE_RESERVED_00000002                0x2
#define global PSS_CAPTURE_HANDLES                          0x4
#define global PSS_CAPTURE_HANDLE_NAME_INFORMATION          0x8
#define global PSS_CAPTURE_HANDLE_BASIC_INFORMATION         0x10
#define global PSS_CAPTURE_HANDLE_TYPE_SPECIFIC_INFORMATION 0x20
#define global PSS_CAPTURE_HANDLE_TRACE                     0x40
#define global PSS_CAPTURE_THREADS                          0x80
#define global PSS_CAPTURE_THREAD_CONTEXT                   0x100
#define global PSS_CAPTURE_THREAD_CONTEXT_EXTENDED          0x200
#define global PSS_CAPTURE_RESERVED_00000400                0x400
#define global PSS_CAPTURE_VA_SPACE                         0x800
#define global PSS_CAPTURE_VA_SPACE_SECTION_INFORMATION     0x1000
#define global PSS_CAPTURE_IPT_TRACE                        0x2000
#define global PSS_CAPTURE_RESERVED_00004000                0x4000
#define global PSS_CREATE_BREAKAWAY_OPTIONAL                0x4000000
#define global PSS_CREATE_BREAKAWAY                         0x8000000
#define global PSS_CREATE_FORCE_BREAKAWAY                   0x10000000
#define global PSS_CREATE_USE_VM_ALLOCATIONS                0x20000000
#define global PSS_CREATE_MEASURE_PERFORMANCE               0x40000000
#define global PSS_CREATE_RELEASE_SECTION                   0x80000000
; ※フラグ列挙型。ビットORで組み合わせ可(例: FOO|BAR)。