Win32 API 日本語リファレンス
ホームSystem.Threading › CRITICAL_SECTION_DEBUG

CRITICAL_SECTION_DEBUG

構造体
サイズx64: 48 バイト / x86: 32 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
TypeWORD2+0+0クリティカルセクションデバッグ情報の種別。
CreatorBackTraceIndexWORD2+2+2作成時のバックトレースインデックス。
CriticalSectionCRITICAL_SECTION*8/4+8+4対応するCRITICAL_SECTION構造体へのポインタ。
ProcessLocksListLIST_ENTRY16/8+16+8プロセス内クリティカルセクションを連結するリストエントリ。
EntryCountDWORD4+32+16クリティカルセクションへの取得試行回数。
ContentionCountDWORD4+36+20ロック競合(待機が発生)した回数。
FlagsDWORD4+40+24デバッグ情報の動作を示すフラグ。
CreatorBackTraceIndexHighWORD2+44+28作成時バックトレースインデックスの上位部分。
IdentifierWORD2+46+30識別子。デバッグ目的の予約値。

各言語での定義

#include <windows.h>

// LIST_ENTRY  (x64 16 / x86 8 バイト)
typedef struct LIST_ENTRY {
    LIST_ENTRY* Flink;
    LIST_ENTRY* Blink;
} LIST_ENTRY;

// CRITICAL_SECTION_DEBUG  (x64 48 / x86 32 バイト)
typedef struct CRITICAL_SECTION_DEBUG {
    WORD Type;
    WORD CreatorBackTraceIndex;
    CRITICAL_SECTION* CriticalSection;
    LIST_ENTRY ProcessLocksList;
    DWORD EntryCount;
    DWORD ContentionCount;
    DWORD Flags;
    WORD CreatorBackTraceIndexHigh;
    WORD Identifier;
} CRITICAL_SECTION_DEBUG;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LIST_ENTRY
{
    public IntPtr Flink;
    public IntPtr Blink;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CRITICAL_SECTION_DEBUG
{
    public ushort Type;
    public ushort CreatorBackTraceIndex;
    public IntPtr CriticalSection;
    public LIST_ENTRY ProcessLocksList;
    public uint EntryCount;
    public uint ContentionCount;
    public uint Flags;
    public ushort CreatorBackTraceIndexHigh;
    public ushort Identifier;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LIST_ENTRY
    Public Flink As IntPtr
    Public Blink As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CRITICAL_SECTION_DEBUG
    Public Type As UShort
    Public CreatorBackTraceIndex As UShort
    Public CriticalSection As IntPtr
    Public ProcessLocksList As LIST_ENTRY
    Public EntryCount As UInteger
    Public ContentionCount As UInteger
    Public Flags As UInteger
    Public CreatorBackTraceIndexHigh As UShort
    Public Identifier As UShort
End Structure
import ctypes
from ctypes import wintypes

class LIST_ENTRY(ctypes.Structure):
    _fields_ = [
        ("Flink", ctypes.c_void_p),
        ("Blink", ctypes.c_void_p),
    ]

class CRITICAL_SECTION_DEBUG(ctypes.Structure):
    _fields_ = [
        ("Type", ctypes.c_ushort),
        ("CreatorBackTraceIndex", ctypes.c_ushort),
        ("CriticalSection", ctypes.c_void_p),
        ("ProcessLocksList", LIST_ENTRY),
        ("EntryCount", wintypes.DWORD),
        ("ContentionCount", wintypes.DWORD),
        ("Flags", wintypes.DWORD),
        ("CreatorBackTraceIndexHigh", ctypes.c_ushort),
        ("Identifier", ctypes.c_ushort),
    ]
#[repr(C)]
pub struct LIST_ENTRY {
    pub Flink: *mut core::ffi::c_void,
    pub Blink: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct CRITICAL_SECTION_DEBUG {
    pub Type: u16,
    pub CreatorBackTraceIndex: u16,
    pub CriticalSection: *mut core::ffi::c_void,
    pub ProcessLocksList: LIST_ENTRY,
    pub EntryCount: u32,
    pub ContentionCount: u32,
    pub Flags: u32,
    pub CreatorBackTraceIndexHigh: u16,
    pub Identifier: u16,
}
import "golang.org/x/sys/windows"

type LIST_ENTRY struct {
	Flink uintptr
	Blink uintptr
}

type CRITICAL_SECTION_DEBUG struct {
	Type uint16
	CreatorBackTraceIndex uint16
	CriticalSection uintptr
	ProcessLocksList LIST_ENTRY
	EntryCount uint32
	ContentionCount uint32
	Flags uint32
	CreatorBackTraceIndexHigh uint16
	Identifier uint16
}
type
  LIST_ENTRY = record
    Flink: Pointer;
    Blink: Pointer;
  end;

  CRITICAL_SECTION_DEBUG = record
    Type: Word;
    CreatorBackTraceIndex: Word;
    CriticalSection: Pointer;
    ProcessLocksList: LIST_ENTRY;
    EntryCount: DWORD;
    ContentionCount: DWORD;
    Flags: DWORD;
    CreatorBackTraceIndexHigh: Word;
    Identifier: Word;
  end;
const LIST_ENTRY = extern struct {
    Flink: ?*anyopaque,
    Blink: ?*anyopaque,
};

const CRITICAL_SECTION_DEBUG = extern struct {
    Type: u16,
    CreatorBackTraceIndex: u16,
    CriticalSection: ?*anyopaque,
    ProcessLocksList: LIST_ENTRY,
    EntryCount: u32,
    ContentionCount: u32,
    Flags: u32,
    CreatorBackTraceIndexHigh: u16,
    Identifier: u16,
};
type
  LIST_ENTRY {.bycopy.} = object
    Flink: pointer
    Blink: pointer

  CRITICAL_SECTION_DEBUG {.bycopy.} = object
    Type: uint16
    CreatorBackTraceIndex: uint16
    CriticalSection: pointer
    ProcessLocksList: LIST_ENTRY
    EntryCount: uint32
    ContentionCount: uint32
    Flags: uint32
    CreatorBackTraceIndexHigh: uint16
    Identifier: uint16
struct LIST_ENTRY
{
    void* Flink;
    void* Blink;
}

struct CRITICAL_SECTION_DEBUG
{
    ushort Type;
    ushort CreatorBackTraceIndex;
    void* CriticalSection;
    LIST_ENTRY ProcessLocksList;
    uint EntryCount;
    uint ContentionCount;
    uint Flags;
    ushort CreatorBackTraceIndexHigh;
    ushort Identifier;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CRITICAL_SECTION_DEBUG サイズ: 32 バイト(x86)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; Type : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; CreatorBackTraceIndex : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; CriticalSection : CRITICAL_SECTION* (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ProcessLocksList : LIST_ENTRY (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; EntryCount : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ContentionCount : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Flags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; CreatorBackTraceIndexHigh : WORD (+28, 2byte)  wpoke st,28,値  /  値 = wpeek(st,28)
; Identifier : WORD (+30, 2byte)  wpoke st,30,値  /  値 = wpeek(st,30)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CRITICAL_SECTION_DEBUG サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Type : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; CreatorBackTraceIndex : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; CriticalSection : CRITICAL_SECTION* (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ProcessLocksList : LIST_ENTRY (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; EntryCount : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ContentionCount : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; Flags : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; CreatorBackTraceIndexHigh : WORD (+44, 2byte)  wpoke st,44,値  /  値 = wpeek(st,44)
; Identifier : WORD (+46, 2byte)  wpoke st,46,値  /  値 = wpeek(st,46)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global LIST_ENTRY
    #field intptr Flink
    #field intptr Blink
#endstruct

#defstruct global CRITICAL_SECTION_DEBUG
    #field short Type
    #field short CreatorBackTraceIndex
    #field intptr CriticalSection
    #field LIST_ENTRY ProcessLocksList
    #field int EntryCount
    #field int ContentionCount
    #field int Flags
    #field short CreatorBackTraceIndexHigh
    #field short Identifier
#endstruct

stdim st, CRITICAL_SECTION_DEBUG        ; NSTRUCT 変数を確保
st->Type = 100
mes "Type=" + st->Type