跳转到内容

std.os.windows

标准库Zig 0.17.0官方原文
源码std/os/windows.zig

第 1 行

此文件为 Windows 专有接口提供轻量封装,具体 目标如下:

  • 将“errno”风格的错误码转换为 Zig 错误。
  • 在需要空字符结尾或 WTF16LE 字节缓冲区时,既提供接受 切片的接口,也提供接受空字符结尾的 WTF16LE 字节缓冲区的接口。

std.os.windows.ACCESS_MASK

容器

第 2463 行

字段

SPECIFIC: Specific = .{ .bits = 0 }
STANDARD: Standard = .{}
Reserved21: u3 = 0
ACCESS_SYSTEM_SECURITY: bool = false
MAXIMUM_ALLOWED: bool = false
Reserved26: u2 = 0
GENERIC: Generic = .{}

std.os.windows.ACCESS_MASK.Generic

容器

第 3336 行

字段

ALL: bool = false
EXECUTE: bool = false
WRITE: bool = false
READ: bool = false

std.os.windows.ACCESS_MASK.Specific

容器

第 2472 行

字段

bits: u16
FILE: File

定义文件与目录的访问权限

FILE_DIRECTORY: File.Directory
FILE_PIPE: File.Pipe
KEY: Key

注册表专用访问权限。

OBJECT_TYPE: ObjectType

对象管理器中对象类型专属的访问权限。

DIRECTORY: Directory

对象管理器目录专属访问权限。

SYMBOLIC_LINK: SymbolicLink

对象管理器符号链接专用访问权限。

SECTION: Section

节访问权限。

SESSION: Session

会话特定访问权限。

PROCESS: Process

进程专属访问权限。

THREAD: Thread

线程专属访问权限。

MEMORY_PARTITION: MemoryPartition

分区特定访问权限。

TRANSACTIONMANAGER: TransactionManager

事务管理器权限的通用映射。

TRANSACTION: Transaction

事务权限的通用映射。

RESOURCEMANAGER: ResourceManager

资源管理器权限的通用映射。

ENLISTMENT: Enlistment

事务登记权限的通用映射。

EVENT: Event

事件特定访问权限。

SEMAPHORE: Semaphore

信号量专用访问权限。

TOKEN: Token

令牌专属访问权限。

JOB_OBJECT: JobObject

作业对象专属访问权限。

MUTANT: Mutant

互斥对象专用访问权限。

TIMER: Timer

计时器专用访问权限。

IO_COMPLETION: IoCompletion

输入输出完成对象的特定访问权限。

std.os.windows.ACCESS_MASK.Specific.Directory

容器

第 2703 行

字段

QUERY: bool = false
TRAVERSE: bool = false
CREATE_OBJECT: bool = false
CREATE_SUBDIRECTORY: bool = false
Reserved3: u12 = 0

std.os.windows.ACCESS_MASK.Specific.Directory.ALL_ACCESS

常量

第 2710 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Enlistment

容器

第 3065 行

字段

QUERY_INFORMATION: bool = false
SET_INFORMATION: bool = false
RECOVER: bool = false
SUBORDINATE_RIGHTS: bool = false
SUPERIOR_RIGHTS: bool = false
Reserved5: u11 = 0

std.os.windows.ACCESS_MASK.Specific.Enlistment.ALL_ACCESS

常量

第 3099 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_EXECUTE

常量

第 3090 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_READ

常量

第 3073 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_WRITE

常量

第 3080 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Event

容器

第 3111 行

字段

QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.Event.ALL_ACCESS

常量

第 3116 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.File

容器

第 2528 行

字段

READ_DATA: bool = false
WRITE_DATA: bool = false
APPEND_DATA: bool = false
READ_EA: bool = false
WRITE_EA: bool = false
EXECUTE: bool = false
Reserved6: u1 = 0
READ_ATTRIBUTES: bool = false
WRITE_ATTRIBUTES: bool = false
Reserved9: u7 = 0

std.os.windows.ACCESS_MASK.Specific.File.ALL_ACCESS

常量

第 2540 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.File.Directory

容器

第 2594 行

字段

LIST: bool = false
ADD_FILE: bool = false
ADD_SUBDIRECTORY: bool = false
READ_EA: bool = false
WRITE_EA: bool = false
TRAVERSE: bool = false
DELETE_CHILD: bool = false
READ_ATTRIBUTES: bool = false
WRITE_ATTRIBUTES: bool = false
Reserved9: u7 = 0

std.os.windows.ACCESS_MASK.Specific.File.GENERIC_EXECUTE

常量

第 2583 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.File.GENERIC_READ

常量

第 2558 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.File.GENERIC_WRITE

常量

第 2570 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.File.Pipe

容器

第 2607 行

字段

READ_DATA: bool = false
WRITE_DATA: bool = false
CREATE_PIPE_INSTANCE: bool = false
Reserved3: u4 = 0
READ_ATTRIBUTES: bool = false
WRITE_ATTRIBUTES: bool = false
Reserved9: u7 = 0

std.os.windows.ACCESS_MASK.Specific.IoCompletion

容器

第 3283 行

字段

Reserved0: u1 = 0
MODIFY_STATE: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.IoCompletion.ALL_ACCESS

常量

第 3288 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.JobObject

容器

第 3226 行

字段

ASSIGN_PROCESS: bool = false
SET_ATTRIBUTES: bool = false
QUERY: bool = false
TERMINATE: bool = false
SET_SECURITY_ATTRIBUTES: bool = false
IMPERSONATE: bool = false
Reserved6: u10 = 0

std.os.windows.ACCESS_MASK.Specific.JobObject.ALL_ACCESS

常量

第 3235 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Key

容器

第 2618 行

字段

QUERY_VALUE: bool = false

查询注册表键值所需的权限。

SET_VALUE: bool = false

创建、删除或设置注册表值所需的权限。

CREATE_SUB_KEY: bool = false

创建注册表项的子键所需的权限。

ENUMERATE_SUB_KEYS: bool = false

枚举注册表键的子键所需的权限。

NOTIFY: bool = false

请求注册表键或其子键的更改通知时所需的权限。

CREATE_LINK: bool = false

预留供系统使用。

Reserved6: u2 = 0
WOW64_64KEY: bool = false

表示 64 位 Windows 上的应用程序应使用 64 位注册表视图。 32 位 Windows 忽略此标志。

WOW64_32KEY: bool = false

指示 64 位 Windows 上的应用程序应操作 32 位注册表视图。 32 位 Windows 忽略此标志。

Reserved10: u6 = 0

std.os.windows.ACCESS_MASK.Specific.Key.ALL_ACCESS

常量

第 2675 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Key.EXECUTE

别名

第 2673 行

等同于 KEY_READ。

别名目标 std.os.windows.ACCESS_MASK.Specific.Key.READ

std.os.windows.ACCESS_MASK.Specific.Key.READ

常量

第 2648 行

组合 STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS 和 KEY_NOTIFY 的值。

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Key.WOW64_RES

常量

第 2640 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Key.WRITE

常量

第 2661 行

组合 STANDARD_RIGHTS_WRITE、KEY_SET_VALUE 和 KEY_CREATE_SUB_KEY 访问权限。

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.MemoryPartition

容器

第 2861 行

字段

QUERY_ACCESS: bool = false
MODIFY_ACCESS: bool = false
Required2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.MemoryPartition.ALL_ACCESS

常量

第 2866 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Mutant

容器

第 3251 行

字段

QUERY_STATE: bool = false
Reserved1: u15 = 0

std.os.windows.ACCESS_MASK.Specific.Mutant.ALL_ACCESS

常量

第 3255 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.ObjectType

容器

第 2691 行

字段

CREATE: bool = false
Reserved1: u15 = 0

std.os.windows.ACCESS_MASK.Specific.ObjectType.ALL_ACCESS

常量

第 2695 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Process

容器

第 2779 行

字段

TERMINATE: bool = false
CREATE_THREAD: bool = false
SET_SESSIONID: bool = false
VM_OPERATION: bool = false
VM_READ: bool = false
VM_WRITE: bool = false
DUP_HANDLE: bool = false
CREATE_PROCESS: bool = false
SET_QUOTA: bool = false
SET_INFORMATION: bool = false
QUERY_INFORMATION: bool = false
SUSPEND_RESUME: bool = false
QUERY_LIMITED_INFORMATION: bool = false
SET_LIMITED_INFORMATION: bool = false
Reserved14: u2 = 0

std.os.windows.ACCESS_MASK.Specific.Process.ALL_ACCESS

常量

第 2796 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.ResourceManager

容器

第 3000 行

字段

QUERY_INFORMATION: bool = false
SET_INFORMATION: bool = false
RECOVER: bool = false
ENLIST: bool = false
GET_NOTIFICATION: bool = false
REGISTER_PROTOCOL: bool = false
COMPLETE_PROPAGATION: bool = false
Reserved7: u9 = 0

std.os.windows.ACCESS_MASK.Specific.ResourceManager.ALL_ACCESS

常量

第 3048 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_EXECUTE

常量

第 3035 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_READ

常量

第 3010 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_WRITE

常量

第 3020 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.RIGHTS_ALL

常量

第 3297 行

Specific

std.os.windows.ACCESS_MASK.Specific.Section

容器

第 2743 行

字段

QUERY: bool = false
MAP_WRITE: bool = false
MAP_READ: bool = false
MAP_EXECUTE: bool = false
EXTEND_SIZE: bool = false
MAP_EXECUTE_EXPLICIT: bool = false

不包含在 ALL_ACCESS 中

Reserved6: u10 = 0

std.os.windows.ACCESS_MASK.Specific.Section.ALL_ACCESS

常量

第 2753 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Semaphore

容器

第 3128 行

字段

QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.Semaphore.ALL_ACCESS

常量

第 3133 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Session

容器

第 2765 行

字段

QUERY_ACCESS: bool = false
MODIFY_ACCESS: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.Session.ALL_ACCESS

常量

第 2770 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.SymbolicLink

容器

第 2721 行

字段

QUERY: bool = false
SET: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.SymbolicLink.ALL_ACCESS

常量

第 2726 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.SymbolicLink.ALL_ACCESS_EX

常量

第 2733 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Thread

容器

第 2821 行

字段

TERMINATE: bool = false
SUSPEND_RESUME: bool = false
ALERT: bool = false
GET_CONTEXT: bool = false
SET_CONTEXT: bool = false
SET_INFORMATION: bool = false
QUERY_INFORMATION: bool = false
SET_THREAD_TOKEN: bool = false
IMPERSONATE: bool = false
DIRECT_IMPERSONATION: bool = false
SET_LIMITED_INFORMATION: bool = false
QUERY_LIMITED_INFORMATION: bool = false
RESUME: bool = false
Reserved13: u3 = 0

std.os.windows.ACCESS_MASK.Specific.Thread.ALL_ACCESS

常量

第 2837 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Timer

容器

第 3266 行

字段

QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0

std.os.windows.ACCESS_MASK.Specific.Timer.ALL_ACCESS

常量

第 3271 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token

容器

第 3145 行

字段

ASSIGN_PRIMARY: bool = false
DUPLICATE: bool = false
IMPERSONATE: bool = false
QUERY: bool = false
QUERY_SOURCE: bool = false
ADJUST_PRIVILEGES: bool = false
ADJUST_GROUPS: bool = false
ADJUST_DEFAULT: bool = false
ADJUST_SESSIONID: bool = false
Reserved9: u7 = 0

std.os.windows.ACCESS_MASK.Specific.Token.ALL_ACCESS

常量

第 3171 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.ALL_ACCESS_P

常量

第 3157 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.EXECUTE

常量

第 3202 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.READ

常量

第 3186 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.TRUST_ALLOWED_MASK

常量

第 3215 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.TRUST_CONSTRAINT_MASK

常量

第 3207 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Token.WRITE

常量

第 3193 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Transaction

容器

第 2923 行

字段

QUERY_INFORMATION: bool = false
SET_INFORMATION: bool = false
ENLIST: bool = false
COMMIT: bool = false
ROLLBACK: bool = false
PROPAGATE: bool = false
RIGHT_RESERVED1: bool = false
Reserved7: u9 = 0

std.os.windows.ACCESS_MASK.Specific.Transaction.ALL_ACCESS

常量

第 2968 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_EXECUTE

常量

第 2957 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_READ

常量

第 2933 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_WRITE

常量

第 2943 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.Transaction.RESOURCE_MANAGER_RIGHTS

常量

第 2983 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.TransactionManager

容器

第 2878 行

字段

QUERY_INFORMATION: bool = false
SET_INFORMATION: bool = false
RECOVER: bool = false
RENAME: bool = false
CREATE_RM: bool = false
BIND_TRANSACTION: bool = false

以下权限仅供 DTC 使用;它将被弃用,其他调用方不应依赖它。

Reserved6: u10 = 0

std.os.windows.ACCESS_MASK.Specific.TransactionManager.ALL_ACCESS

常量

第 2910 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_EXECUTE

常量

第 2905 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_READ

常量

第 2888 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_WRITE

常量

第 2895 行

ACCESS_MASK

std.os.windows.ACCESS_MASK.Standard

容器

第 3300 行

字段

RIGHTS: Rights = .{}
SYNCHRONIZE: bool = false

std.os.windows.ACCESS_MASK.Standard.Rights

容器

第 3309 行

字段

DELETE: bool = false
READ_CONTROL: bool = false
WRITE_DAC: bool = false
WRITE_OWNER: bool = false

std.os.windows.ACCESS_MASK.Standard.RIGHTS_ALL

常量

第 3304 行

Standard

std.os.windows.ACCESS_MASK.Standard.Rights.ALL

别名

第 3332 行

别名目标 std.os.windows.ACCESS_MASK.Standard.Rights.REQUIRED

std.os.windows.ACCESS_MASK.Standard.Rights.EXECUTE

常量

第 3328 行

Rights

std.os.windows.ACCESS_MASK.Standard.Rights.READ

常量

第 3322 行

Rights

std.os.windows.ACCESS_MASK.Standard.Rights.REQUIRED

常量

第 3315 行

Rights

std.os.windows.ACCESS_MASK.Standard.Rights.WRITE

常量

第 3325 行

Rights

std.os.windows.ACTIVATION_CONTEXT_DATA

容器

第 5023 行

std.os.windows.AFD

容器

第 1125 行

字段

NO_FAST_IO: bool = false
OVERLAPPED: bool = false
Reserved0: u30 = 0

std.os.windows.AFD.ACCEPT_INFO

容器

第 1199 行

字段

UseSAN: BOOLEAN
Sequence: ULONG
AcceptHandle: HANDLE

std.os.windows.AFD.BIND_INFO

容器

第 1181 行

字段

Mode: MODE

std.os.windows.AFD.BIND_INFO.MODE

容器

第 1184 行

字段

Unix = 0
Passive = 1
Active = 2
_

std.os.windows.AFD.DEFER_ACCEPT_INFO

容器

第 1214 行

字段

Sequence: ULONG
Reject: BOOLEAN

std.os.windows.AFD.DEVICE_NAME

常量

第 1148 行

[]const u16

std.os.windows.AFD.ENDPOINT_TYPE

容器

第 1149 行

字段

CONNECTIONLESS: bool = false
Reserved1: u3 = 0
MESSAGEMODE: bool = false
Reserved5: u3 = 0
RAW: bool = false
Reserved9: u22 = 0
REGISTERED_IO: bool = false

std.os.windows.AFD.GUARANTEE

容器

第 1140 行

字段

BestEffort
ControlledLoad
Predictive
GuaranteedDelay
Guaranteed
_

std.os.windows.AFD.HANDLE_INFO

容器

第 1234 行

字段

TdiAddressHandle: HANDLE
TdiConnectionHandle: HANDLE

std.os.windows.AFD.INFORMATION

容器

第 1238 行

字段

InformationType: TYPE
Information: extern union {
    Boolean: BOOLEAN,
    Ulong: ULONG,
    LargeInteger: LARGE_INTEGER,
}

std.os.windows.AFD.INFORMATION.TYPE

容器

第 1246 行

字段

INLINE_MODE = 0x01
NONBLOCKING_MODE = 0x02
MAX_SEND_SIZE = 0x03
SENDS_PENDING = 0x04
MAX_PATH_SEND_SIZE = 0x05
RECEIVE_WINDOW_SIZE = 0x06
SEND_WINDOW_SIZE = 0x07
CONNECT_TIME = 0x08
CIRCULAR_QUEUEING = 0x09
GROUP_ID_AND_TYPE = 0x0A
_

std.os.windows.AFD.LISTEN_INFO

容器

第 1191 行

字段

UseSAN: BOOLEAN
MaximumConnectionQueue: ULONG
UseDelayedAcceptance: BOOLEAN

std.os.windows.AFD.LISTEN_RESPONSE_INFO

容器

第 1196 行

字段

Sequence: ULONG

std.os.windows.AFD.Mutability

容器

第 1130 行

字段

@"const"
@"var"

std.os.windows.AFD.OPEN_PACKET

容器

第 1158 行

字段

EndpointType: ENDPOINT_TYPE
GroupID: LONG
AddressFamily: LONG
SocketType: LONG
Protocol: LONG
TransportDeviceNameLength: ULONG
TransportDeviceName: [1]WCHAR

std.os.windows.AFD.OPEN_PACKET.FULL_EA_INFORMATION

容器

第 1169 行

字段

Header: FILE.FULL_EA_INFORMATION = .{
    .NextEntryOffset = 0,
    .Flags = 0,
    .EaNameLength = NAME.len,
    .EaValueLength = @sizeOf(OPEN_PACKET),
    .EaName = .{},
}
Name: [NAME.len:0]u8 = NAME.*
Value: OPEN_PACKET

std.os.windows.AFD.OPEN_PACKET.NAME

常量

第 1167 行

std.os.windows.AFD.PARTIAL_DISCONNECT_INFO

容器

第 1218 行

字段

DisconnectMode: MODE
Timeout: LARGE_INTEGER

std.os.windows.AFD.PARTIAL_DISCONNECT_INFO.MODE

容器

第 1222 行

字段

SEND: bool = false
RECEIVE: bool = false
ABORTIVE: bool = false
UNCONNECT_DATAGRAM: bool = false
Reserved4: u28 = 0

std.os.windows.AFD.QUEUE_APC_INFO

容器

第 1278 行

字段

Thread: HANDLE
ApcRoutine: PVOID
ApcContext: PVOID
SystemArgument1: PVOID
SystemArgument2: PVOID

std.os.windows.AFD.RECEIVE_INFORMATION

容器

第 1230 行

字段

BytesAvailable: ULONG
ExpeditedBytesAvailable: ULONG

std.os.windows.AFD.RECV_DATAGRAM_INFO

容器

第 1304 行

字段

BufferArray: [*]const WSABUF(.@"var")
BufferCount: ULONG
AfdFlags: AFD
TdiFlags: TDI.RECEIVE
Address: PVOID
AddressLength: *ULONG

std.os.windows.AFD.RECV_INFO

容器

第 1298 行

字段

BufferArray: [*]const WSABUF(.@"var")
BufferCount: ULONG
AfdFlags: AFD
TdiFlags: TDI.RECEIVE

std.os.windows.AFD.SEND_DATAGRAM_INFO

容器

第 1291 行

字段

BufferArray: [*]const WSABUF(.@"const")
BufferCount: ULONG
AfdFlags: AFD
TdiRequest: TDI.REQUEST.SEND_DATAGRAM
TdiConnInfo: TDI.CONNECTION.INFORMATION

std.os.windows.AFD.SEND_INFO

容器

第 1285 行

字段

BufferArray: [*]const WSABUF(.@"const")
BufferCount: ULONG
AfdFlags: AFD
TdiFlags: TDI.SEND

std.os.windows.AFD.SOCKOPT_INFO

容器

第 1312 行

字段

mode: Mode
level: i32
optname: u32
ding: u32 = 1
optval: *const anyopaque
optlen: usize

std.os.windows.AFD.SOCKOPT_INFO.Mode

容器

第 1320 行

字段

set = 1
get = 2
special = 3
_

std.os.windows.AFD.SOCKOPT_INFO.UNIX_PATH

容器

第 1322 行

字段

Unknown0: usize = 0
Path: [PATH_MAX_WIDE:0]u16

std.os.windows.AFD.SUPER_ACCEPT_INFO

容器

第 1204 行

字段

UseSAN: BOOLEAN
AcceptHandle: HANDLE
AcceptEndpoint: PVOID
AcceptFileObject: PVOID
ReceiveDataLength: ULONG
LocalAddressLength: ULONG
RemoteAddressLength: ULONG
ListenResponseInfo: LISTEN_RESPONSE_INFO

std.os.windows.AFD.TRANSMIT_FILE_INFO

容器

第 1260 行

字段

Offset: LARGE_INTEGER
WriteLength: LARGE_INTEGER
SendPacketLength: ULONG
FileHandle: HANDLE
Head: PVOID
HeadLength: ULONG
Tail: PVOID
TailLength: ULONG
Flags: FLAGS

std.os.windows.AFD.TRANSMIT_FILE_INFO.FLAGS

容器

第 1271 行

字段

DISCONNECT: bool = false
REUSE_SOCKET: bool = false
WRITE_BEHIND: bool = false
Reserved3: u25 = 0

std.os.windows.AFD.WSABUF

类型函数

第 1131 行

pub fn WSABUF(comptime mutability: Mutability) type

参数

mutability: Mutability

字段

len: ULONG
buf: switch (mutability) {
    .@"const" => [*]const u8,
    .@"var" => [*]u8,
}

std.os.windows.ALTERNATIVE_ARCHITECTURE_TYPE

容器

第 5843 行

字段

StandardDesign
NEC98x86
EndAlternatives

std.os.windows.ANSI_STRING

类型

第 4128 行

std.os.windows.ASSEMBLY_STORAGE_MAP

容器

第 5024 行

std.os.windows.assert

别名

第 13 行

别名目标 std.debug.assert

std.os.windows.ATOM

类型

第 4033 行

std.os.windows.BACKGROUND_BLUE

常量

第 4521 行

std.os.windows.BACKGROUND_GREEN

常量

第 4522 行

std.os.windows.BACKGROUND_INTENSITY

常量

第 4524 行

std.os.windows.BACKGROUND_RED

常量

第 4523 行

std.os.windows.BASE_STATIC_SERVER_DATA

容器

第 6030 行

字段

windows_directory: ForeignString
windows_system_directory: ForeignString
named_object_directory: ForeignString

std.os.windows.BASE_STATIC_SERVER_DATA.ForeignString

容器

第 6036 行

此项与 64 位版本的 UNICODE_STRING 匹配;即便目标为 32 位,此字符串也来自 64 位代码(因为它来自运行在 WOW64 之外的 CSRSS)。

字段

length: u16
maximum_length: u16
buffer_address: u64

CSRSS 地址空间中的地址。若要将其转换为本进程地址空间中的有效指针, 参见 relocateCsrssAddress 或其包装函数 ForeignString.relocate。

std.os.windows.BASE_STATIC_SERVER_DATA.ForeignString.relocate

函数

第 6042 行

fn relocate(str: ForeignString) UNICODE_STRING

参数

std.os.windows.Bool

类型函数

第 4131 行

fn Bool(comptime BackingInteger: type) type

参数

BackingInteger: type

字段

FALSE = 0

false

_

true

std.os.windows.BOOL

类型

第 4025 行

std.os.windows.Bool.Backing

常量

第 4141 行

std.os.windows.Bool.fromBool

函数

第 4147 行

pub fn fromBool(b: bool) @This()

参数

b: bool

std.os.windows.Bool.toBool

函数

第 4143 行

pub fn toBool(b: @This()) bool

参数

b: @This()

std.os.windows.Bool.TRUE

常量

第 4139 行

这不是唯一的真值;与此值进行比较始终是缺陷。

@This()

std.os.windows.BOOLEAN

类型

第 4026 行

std.os.windows.BSTR

类型

第 4056 行

由 SysAllocString 分配,由 SysFreeString 释放。

std.os.windows.builtin

常量

第 7 行

std.os.windows.BYTE

类型

第 4027 行

std.os.windows.CHAR

类型

第 4028 行

std.os.windows.CLIENT_ID

容器

第 5030 行

字段

UniqueProcess: ?HANDLE
UniqueThread: ?HANDLE

std.os.windows.CloseHandle

函数

第 3604 行

pub fn CloseHandle(hObject: HANDLE) void

参数

hObject: HANDLE

std.os.windows.COLORREF

别名

第 4076 行

别名目标 std.os.windows.DWORD

std.os.windows.CONDITION_VARIABLE

容器

第 5561 行

字段

Ptr: ?PVOID = null

std.os.windows.CONDITION_VARIABLE_INIT

常量

第 5560 行

std.os.windows.CONSOLE

命名空间

第 902 行

std.os.windows.CONSOLE.USER_IO

命名空间

第 903 行

std.os.windows.CONSOLE.USER_IO.FILL

函数

第 990 行

pub fn FILL(with: INFO.FILL.WITH, len: DWORD, coord: COORD) Header.With(INFO.FILL)

参数

with: INFO.FILL.WITH
len: DWORD
coord: COORD

std.os.windows.CONSOLE.USER_IO.GET_CP

函数

第 980 行

pub fn GET_CP(mode: INFO.CP.MODE) Header.With(INFO.CP)

参数

mode: INFO.CP.MODE

std.os.windows.CONSOLE.USER_IO.GET_MODE

常量

第 983 行

Header.With(DWORD)

std.os.windows.CONSOLE.USER_IO.GET_SCREEN_BUFFER_INFO

常量

第 1007 行

Header.With(INFO.SCREEN_BUFFER)

std.os.windows.CONSOLE.USER_IO.Header

容器

第 1060 行

字段

Operation: Operation
Size: u32

std.os.windows.CONSOLE.USER_IO.Header.With

类型函数

第 1064 行

pub fn With(comptime Data: type) type

参数

Data: type

字段

Header: Header
Data: Data

std.os.windows.CONSOLE.USER_IO.Header.With.init

函数

第 1069 行

pub fn init(operation: Operation, data: Data) @This()

参数

operation: Operation
data: Data

std.os.windows.CONSOLE.USER_IO.Header.With.operate

函数

第 1094 行

pub fn operate(with: *@This(), io: Io, file: ?Io.File) Io.Cancelable!NTSTATUS

参数

with: *@This()
io: Io
file: ?Io.File

错误

Canceled

调用方请求停止异步操作。

std.os.windows.CONSOLE.USER_IO.Header.With.request

函数

第 1076 行

pub fn request( with: *@This(), file: ?Io.File, comptime in_len: u32, in: [in_len]InputBuffer, comptime out_len: u32, out: [out_len]OutputBuffer, ) Request(1 + in_len, 1 + out_len)

参数

with: *@This()
file: ?Io.File
in_len: u32
in: [in_len]InputBuffer
out_len: u32
out: [out_len]OutputBuffer

std.os.windows.CONSOLE.USER_IO.INFO

命名空间

第 904 行

std.os.windows.CONSOLE.USER_IO.INFO.CP

容器

第 905 行

字段

CodePage: UINT

GetCP:输出 SetCP:输入

Mode: MODE

输入

std.os.windows.CONSOLE.USER_IO.INFO.CP.MODE

容器

第 912 行

字段

Input
Output

std.os.windows.CONSOLE.USER_IO.INFO.FILL

容器

第 930 行

字段

dwWriteCoord: COORD

输入

Tag: WITH.Tag

输入

With: WITH.Payload

输入

nLength: DWORD

输入/输出,单位为字符

std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH

容器

第 940 行

字段

Character: CHAR = 1
WideCharacter: WCHAR = 2
Attribute: WORD = 3

std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH.Payload

常量

第 946 行

std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH.Tag

常量

第 945 行

std.os.windows.CONSOLE.USER_IO.INFO.READ_OUTPUT_CHARACTER

容器

第 966 行

字段

dwReadCoord: COORD

输入

Mode: MODE
nLength: DWORD

输出,以字符计

std.os.windows.CONSOLE.USER_IO.INFO.READ_OUTPUT_CHARACTER.MODE

容器

第 973 行

字段

Character = 1
WideCharacter = 2

std.os.windows.CONSOLE.USER_IO.INFO.SCREEN_BUFFER

容器

第 954 行

全部输出

字段

dwSize: COORD
dwCursorPosition: COORD
dwWindowPosition: COORD
wAttributes: WORD
dwWindowSize: COORD
dwMaximumWindowSize: COORD
wPopupAttributes: WORD
bFullscreenSupported: BOOL
ColorTable: [16]COLORREF

std.os.windows.CONSOLE.USER_IO.INFO.WRITE

容器

第 918 行

字段

Size: DWORD

输出,以字节计

Mode: MODE

输入

std.os.windows.CONSOLE.USER_IO.INFO.WRITE.MODE

容器

第 924 行

字段

Character
WideCharacter

std.os.windows.CONSOLE.USER_IO.InputBuffer

容器

第 1026 行

字段

Size: u32
Pointer: *const anyopaque

std.os.windows.CONSOLE.USER_IO.Operation

容器

第 1108 行

字段

GetCP = 0x1000000
GetMode = 0x1000001
SetMode = 0x1000002
Read = 0x1000005
Write = 0x1000006
Fill = 0x2000000
SetCP = 0x2000004
GetScreenBufferInfo = 0x2000007
SetCursorPosition = 0x200000a
SetTextAttribute = 0x200000d
ReadOutputCharacter = 0x200000f
_

std.os.windows.CONSOLE.USER_IO.OutputBuffer

容器

第 1031 行

字段

Size: u32
Pointer: *anyopaque

std.os.windows.CONSOLE.USER_IO.READ_OUTPUT_CHARACTER

函数

第 1015 行

pub fn READ_OUTPUT_CHARACTER( coord: COORD, mode: INFO.READ_OUTPUT_CHARACTER.MODE, ) Header.With(INFO.READ_OUTPUT_CHARACTER)

参数

std.os.windows.CONSOLE.USER_IO.Request

类型函数

第 1036 行

pub fn Request(comptime in_len: u32, comptime out_len: u32) type

参数

in_len: u32
out_len: u32

字段

Handle: ?HANDLE
InputBuffersLength: u32
OutputBuffersLength: u32
InputBuffers: [in_len]InputBuffer
OutputBuffers: [out_len]OutputBuffer

std.os.windows.CONSOLE.USER_IO.Request.init

函数

第 1044 行

pub fn init( handle: ?HANDLE, in: [in_len]InputBuffer, out: [out_len]OutputBuffer, ) @This()

参数

handle: ?HANDLE
in: [in_len]InputBuffer
out: [out_len]OutputBuffer

std.os.windows.CONSOLE.USER_IO.SET_CP

函数

第 1004 行

pub fn SET_CP(mode: INFO.CP.MODE, cp: UINT) Header.With(INFO.CP)

参数

mode: INFO.CP.MODE
cp: UINT

std.os.windows.CONSOLE.USER_IO.SET_CURSOR_POSITION

函数

第 1009 行

pub fn SET_CURSOR_POSITION(coord: COORD) Header.With(COORD)

参数

coord: COORD

std.os.windows.CONSOLE.USER_IO.SET_MODE

函数

第 984 行

pub fn SET_MODE(mode: DWORD) Header.With(DWORD)

参数

mode: DWORD

std.os.windows.CONSOLE.USER_IO.SET_TEXT_ATTRIBUTE

函数

第 1012 行

pub fn SET_TEXT_ATTRIBUTE(attribute: WORD) Header.With(WORD)

参数

attribute: WORD

std.os.windows.CONSOLE.USER_IO.WRITE

函数

第 987 行

pub fn WRITE(mode: INFO.WRITE.MODE) Header.With(INFO.WRITE)

参数

mode: INFO.WRITE.MODE

std.os.windows.CONTEXT

类型

第 4665 行

std.os.windows.CONTEXT.getRegs

类型函数

第 4693 行

pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }

参数

ctx: *const CONTEXT

std.os.windows.CONTEXT.getRegs

类型函数

第 4768 行

pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }

参数

ctx: *const CONTEXT

std.os.windows.CONTEXT.getRegs

类型函数

第 4812 行

pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }

参数

ctx: *const CONTEXT

std.os.windows.CONTEXT.getRegs

类型函数

第 4877 行

pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }

参数

ctx: *const CONTEXT

std.os.windows.CONTEXT.setIp

函数

第 4772 行

pub fn setIp(ctx: *CONTEXT, ip: usize) void

参数

ctx: *CONTEXT
ip: usize

std.os.windows.CONTEXT.setIp

函数

第 4820 行

pub fn setIp(ctx: *CONTEXT, ip: usize) void

参数

ctx: *CONTEXT
ip: usize

std.os.windows.CONTEXT.setIp

函数

第 4885 行

pub fn setIp(ctx: *CONTEXT, ip: usize) void

参数

ctx: *CONTEXT
ip: usize

std.os.windows.CONTEXT.setSp

函数

第 4776 行

pub fn setSp(ctx: *CONTEXT, sp: usize) void

参数

ctx: *CONTEXT
sp: usize

std.os.windows.CONTEXT.setSp

函数

第 4824 行

pub fn setSp(ctx: *CONTEXT, sp: usize) void

参数

ctx: *CONTEXT
sp: usize

std.os.windows.CONTEXT.setSp

函数

第 4889 行

pub fn setSp(ctx: *CONTEXT, sp: usize) void

参数

ctx: *CONTEXT
sp: usize

std.os.windows.COORD

容器

第 4293 行

字段

X: SHORT
Y: SHORT

std.os.windows.CreateProcessError

错误集合

第 3611 行

错误

AccessDenied
FileBusy
FileNotFound
InvalidExe
InvalidName
NameTooLong
SystemResources
Unexpected

std.os.windows.CreateProcessFlags

容器

第 3622 行

字段

debug_process: bool = false
debug_only_this_process: bool = false
create_suspended: bool = false
detached_process: bool = false
create_new_console: bool = false
normal_priority_class: bool = false
idle_priority_class: bool = false
high_priority_class: bool = false
realtime_priority_class: bool = false
create_new_process_group: bool = false
create_unicode_environment: bool = false
create_separate_wow_vdm: bool = false
create_shared_wow_vdm: bool = false
create_forcedos: bool = false
below_normal_priority_class: bool = false
above_normal_priority_class: bool = false
inherit_parent_affinity: bool = false
inherit_caller_priority: bool = false
create_protected_process: bool = false
extended_startupinfo_present: bool = false
process_mode_background_begin: bool = false
process_mode_background_end: bool = false
create_secure_process: bool = false
_reserved: bool = false
create_breakaway_from_job: bool = false
create_preserve_code_authz_level: bool = false
create_default_error_mode: bool = false
create_no_window: bool = false
profile_user: bool = false
profile_kernel: bool = false
profile_server: bool = false
create_ignore_system_default: bool = false

std.os.windows.CRITICAL_SECTION

别名

第 4552 行

别名目标 std.os.windows.RTL_CRITICAL_SECTION

std.os.windows.crypt32

别名

第 21 行

别名目标 std.os.windows.crypt32

std.os.windows.CTL_CODE

容器

第 2167 行

字段

Method: METHOD
Function: u12
Access: FILE_ACCESS
DeviceType: FILE_DEVICE

std.os.windows.CTL_CODE.FILE_ACCESS

容器

第 2180 行

字段

READ: bool = false
WRITE: bool = false

std.os.windows.CTL_CODE.FILE_ACCESS.ANY

常量

第 2184 行

FILE_ACCESS

std.os.windows.CTL_CODE.FILE_ACCESS.SPECIAL

别名

第 2185 行

别名目标 std.os.windows.CTL_CODE.FILE_ACCESS.ANY

std.os.windows.CTL_CODE.FILE_DEVICE

容器

第 2188 行

字段

BEEP = 0x00000001
CD_ROM = 0x00000002
CD_ROM_FILE_SYSTEM = 0x00000003
CONTROLLER = 0x00000004
DATALINK = 0x00000005
DFS = 0x00000006
DISK = 0x00000007
DISK_FILE_SYSTEM = 0x00000008
FILE_SYSTEM = 0x00000009
INPORT_PORT = 0x0000000a
KEYBOARD = 0x0000000b
MAILSLOT = 0x0000000c
MIDI_IN = 0x0000000d
MIDI_OUT = 0x0000000e
MOUSE = 0x0000000f
MULTI_UNC_PROVIDER = 0x00000010
NAMED_PIPE = 0x00000011
NETWORK = 0x00000012
NETWORK_BROWSER = 0x00000013
NETWORK_FILE_SYSTEM = 0x00000014
NULL = 0x00000015
PARALLEL_PORT = 0x00000016
PHYSICAL_NETCARD = 0x00000017
PRINTER = 0x00000018
SCANNER = 0x00000019
SERIAL_MOUSE_PORT = 0x0000001a
SERIAL_PORT = 0x0000001b
SCREEN = 0x0000001c
SOUND = 0x0000001d
STREAMS = 0x0000001e
TAPE = 0x0000001f
TAPE_FILE_SYSTEM = 0x00000020
TRANSPORT = 0x00000021
UNKNOWN = 0x00000022
VIDEO = 0x00000023
VIRTUAL_DISK = 0x00000024
WAVE_IN = 0x00000025
WAVE_OUT = 0x00000026
@"8042_PORT" = 0x00000027
NETWORK_REDIRECTOR = 0x00000028
BATTERY = 0x00000029
BUS_EXTENDER = 0x0000002a
MODEM = 0x0000002b
VDM = 0x0000002c
MASS_STORAGE = 0x0000002d
SMB = 0x0000002e
KS = 0x0000002f
CHANGER = 0x00000030
SMARTCARD = 0x00000031
ACPI = 0x00000032
DVD = 0x00000033
FULLSCREEN_VIDEO = 0x00000034
DFS_FILE_SYSTEM = 0x00000035
DFS_VOLUME = 0x00000036
SERENUM = 0x00000037
TERMSRV = 0x00000038
KSEC = 0x00000039
FIPS = 0x0000003A
INFINIBAND = 0x0000003B
VMBUS = 0x0000003E
CRYPT_PROVIDER = 0x0000003F
WPD = 0x00000040
BLUETOOTH = 0x00000041
MT_COMPOSITE = 0x00000042
MT_TRANSPORT = 0x00000043
BIOMETRIC = 0x00000044
PMI = 0x00000045
EHSTOR = 0x00000046
DEVAPI = 0x00000047
GPIO = 0x00000048
USBEX = 0x00000049
CONSOLE = 0x00000050
NFP = 0x00000051
SYSENV = 0x00000052
VIRTUAL_BLOCK = 0x00000053
POINT_OF_SERVICE = 0x00000054
STORAGE_REPLICATION = 0x00000055
TRUST_ENV = 0x00000056
UCM = 0x00000057
UCMTCPCI = 0x00000058
PERSISTENT_MEMORY = 0x00000059
NVDIMM = 0x0000005a
HOLOGRAPHIC = 0x0000005b
SDFXHCI = 0x0000005c
UCMUCSI = 0x0000005d
PRM = 0x0000005e
EVENT_COLLECTOR = 0x0000005f
USB4 = 0x00000060
SOUNDWIRE = 0x00000061
MOUNTMGRCONTROLTYPE = 'm'
_

std.os.windows.CTL_CODE.GET_REPARSE_POINT

常量

第 2285 行

CTL_CODE

std.os.windows.CTL_CODE.METHOD

容器

第 2173 行

字段

BUFFERED = 0
IN_DIRECT = 1
OUT_DIRECT = 2
NEITHER = 3

std.os.windows.CTL_CODE.PIPE

命名空间

第 2287 行

std.os.windows.CTL_CODE.PIPE.ASSIGN_EVENT

常量

第 2288 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.DISCONNECT

常量

第 2289 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.FLUSH

常量

第 2304 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.GET_CONNECTION_ATTRIBUTE

常量

第 2300 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.GET_HANDLE_ATTRIBUTE

常量

第 2302 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.GET_PIPE_ATTRIBUTE

常量

第 2298 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.IMPERSONATE

常量

第 2295 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.INTERNAL_READ

常量

第 2306 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.INTERNAL_READ_OVFLOW

常量

第 2309 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.INTERNAL_TRANSCEIVE

常量

第 2308 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.INTERNAL_WRITE

常量

第 2307 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.LISTEN

常量

第 2290 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.PEEK

常量

第 2291 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.QUERY_CLIENT_PROCESS

常量

第 2297 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.QUERY_EVENT

常量

第 2292 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.SET_CLIENT_PROCESS

常量

第 2296 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.SET_CONNECTION_ATTRIBUTE

常量

第 2301 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.SET_HANDLE_ATTRIBUTE

常量

第 2303 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.SET_PIPE_ATTRIBUTE

常量

第 2299 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.TRANSCEIVE

常量

第 2293 行

CTL_CODE

std.os.windows.CTL_CODE.PIPE.WAIT

常量

第 2294 行

CTL_CODE

std.os.windows.CTL_CODE.SET_REPARSE_POINT

常量

第 2284 行

CTL_CODE

std.os.windows.CURDIR

容器

第 5480 行

字段

DosPath: UNICODE_STRING
Handle: HANDLE

std.os.windows.current_process

常量

第 24 行

HANDLE

std.os.windows.DEVICE_TYPE

容器

第 3344 行

字段

FileDevice: CTL_CODE.FILE_DEVICE
Reserved16: u16 = 0

std.os.windows.DIRECTORY

命名空间

第 891 行

std.os.windows.DIRECTORY.NOTIFY_INFORMATION_CLASS

容器

第 892 行

字段

Notify = 1
NotifyExtended = 2
NotifyFull = 3
_

std.os.windows.DIRECTORY.NOTIFY_INFORMATION_CLASS.Maximum

常量

第 898 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.DISABLE_NEWLINE_AUTO_RETURN

常量

第 4515 行

std.os.windows.DNS

命名空间

第 1500 行

std.os.windows.DNS.ADDR

容器

第 1518 行

字段

MaxSa: [ADDR_MAX_SOCKADDR_LENGTH]CHAR
DnsAddrUserDword: [8]DWORD

std.os.windows.DNS.ADDR_MAX_SOCKADDR_LENGTH

常量

第 1516 行

std.os.windows.DNS.ADDR.ARRAY

容器

第 1522 行

字段

MaxCount: DWORD
AddrCount: DWORD
Tag: DWORD
Family: WORD
WordReserved: WORD
Flags: DWORD
MatchFlag: DWORD
Reserved1: DWORD
Reserved2: DWORD
AddrArray: [0]ADDR

std.os.windows.DNS.CUSTOM_SERVER

容器

第 1536 行

字段

ServerType: CUSTOM_SERVER.TYPE
Flags: FLAGS
Info: extern union {
    UDP: void,
    DOH: extern struct { Template: PWSTR },
    DOT: extern struct { Hostname: PWSTR },
}
MaxSa: [ADDR_MAX_SOCKADDR_LENGTH]CHAR

std.os.windows.DNS.CUSTOM_SERVER.FLAGS

容器

第 1547 行

字段

UDP_FALLBACK: bool = false
UPGRADE_FROM_WELL_KNOWN_SERVERS: bool = false
Reserved2: u62 = 0

std.os.windows.DNS.CUSTOM_SERVER.TYPE

容器

第 1546 行

字段

UDP = 0x1
DOH = 0x2
DOT = 0x3
_

std.os.windows.DNS.FREE_TYPE

容器

第 1688 行

字段

Flat = 0
RecordList
ParsedMessageFields

std.os.windows.DNS.INTERFACE_SETTINGS

容器

第 1501 行

字段

Version: ULONG
Flags: ULONG64
Domain: PWSTR
NameServer: PWSTR
SearchList: PWSTR
RegistrationEnabled: ULONG
RegisterAdapterName: ULONG
EnableLLMNR: ULONG
QueryAdapterName: ULONG
ProfileNameServer: PWSTR

std.os.windows.DNS.QUERY

容器

第 1626 行

字段

ACCEPT_TRUNCATED_RESPONSE: bool = false
USE_TCP_ONLY: bool = false
NO_RECURSION: bool = false
BYPASS_CACHE: bool = false
NO_WIRE_QUERY: bool = false
NO_LOCAL_NAME: bool = false
NO_HOSTS_FILE: bool = false
NO_NETBT: bool = false
WIRE_ONLY: bool = false
RETURN_MESSAGE: bool = false
MULTICAST_ONLY: bool = false
NO_MULTICAST: bool = false
TREAT_AS_FQDN: bool = false
ADDRCONFIG: bool = false
DUAL_ADDR: bool = false
Reserved15: u2 = 0
MULTICAST_WAIT: bool = false
MULTICAST_VERIFY: bool = false
Reserved19: u1 = 0
DONT_RESET_TTL_VALUES: bool = false
DISABLE_IDN_ENCODING: bool = false
Reserved22: u1 = 0
APPEND_MULTILABEL: bool = false
Reserved24: u34 = 0
PARSE_ALL_RECORDS: bool = false
Reserved59: u5 = 0

std.os.windows.DNS.QUERY.CANCEL

容器

第 1680 行

字段

Reserved: [32]CHAR align(8)

std.os.windows.DNS.QUERY.COMPLETION_ROUTINE

常量

第 1683 行

std.os.windows.DNS.QUERY.REQUEST

容器

第 1655 行

字段

Version: DWORD
QueryName: PCWSTR
QueryType: TYPE
QueryOptions: QUERY = .STANDARD
pDnsServerList: ?*ADDR.ARRAY = null
InterfaceIndex: ULONG = 0
pQueryCompletionCallback: ?*const COMPLETION_ROUTINE = null
pQueryContext: ?*anyopaque = null

std.os.windows.DNS.QUERY.REQUEST.@"3"

容器

第 1665 行

字段

Base: REQUEST
IsNetworkQueryRequired: BOOL = .FALSE
RequiredNetworkIndex: DWORD = 0
cCustomServers: DWORD = 0
pCustomServers: ?*CUSTOM_SERVER = null

std.os.windows.DNS.QUERY.RESULT

容器

第 1673 行

字段

Version: ULONG
QueryStatus: STATUS
QueryOptions: QUERY
pQueryRecords: ?*RECORD
Reserved: ?*anyopaque

std.os.windows.DNS.QUERY.STANDARD

常量

第 1627 行

QUERY

std.os.windows.DNS.RECORD

容器

第 1689 行

字段

pNext: ?*RECORD
pName: *anyopaque
wType: TYPE
wDataLength: WORD
Flags: FLAGS
dwTtl: DWORD
dwReserved: DWORD
Data: extern union { A: [4]u8, AAAA: [16]u8 }

std.os.windows.DNS.RECORD.FLAGS

容器

第 1699 行

字段

Section: SECTION
Delete: u1
CharSet: u2
Unused: u3
Reserved: u24

std.os.windows.DNS.SECTION

容器

第 1707 行

字段

Question
Answer
Authority
Additional

std.os.windows.DNS.STATUS

别名

第 1556 行

别名目标 std.os.windows.Win32Error

std.os.windows.DNS.TYPE

容器

第 1558 行

字段

A = 0x0001
NS = 0x0002
MD = 0x0003
MF = 0x0004
CNAME = 0x0005
SOA = 0x0006
MB = 0x0007
MG = 0x0008
MR = 0x0009
NULL = 0x000a
WKS = 0x000b
PTR = 0x000c
HINFO = 0x000d
MINFO = 0x000e
MX = 0x000f
TEXT = 0x0010
RP = 0x0011
AFSDB = 0x0012
X25 = 0x0013
ISDN = 0x0014
RT = 0x0015
NSAP = 0x0016
NSAPPTR = 0x0017
SIG = 0x0018
KEY = 0x0019
PX = 0x001a
GPOS = 0x001b
AAAA = 0x001c
LOC = 0x001d
NXT = 0x001e
EID = 0x001f
NIMLOC = 0x0020
SRV = 0x0021
ATMA = 0x0022
NAPTR = 0x0023
KX = 0x0024
CERT = 0x0025
A6 = 0x0026
DNAME = 0x0027
SINK = 0x0028
OPT = 0x0029
DS = 0x002B
RRSIG = 0x002E
NSEC = 0x002F
DNSKEY = 0x0030
DHCID = 0x0031
UINFO = 0x0064
UID = 0x0065
GID = 0x0066
UNSPEC = 0x0067
ADDRS = 0x00f8
TKEY = 0x00f9
TSIG = 0x00fa
IXFR = 0x00fb
AXFR = 0x00fc
MAILB = 0x00fd
MAILA = 0x00fe
ALL = 0x00ff
WINS = 0xff01
WINSR = 0xff02
TLSA = 0x0034
SVCB = 0x0040
HTTPS = 0x0041

std.os.windows.DNS.TYPE.ANY

常量

第 1623 行

TYPE

std.os.windows.DNS.TYPE.NBSTAT

常量

第 1622 行

TYPE

std.os.windows.DUPLICATE_SAME_ACCESS

常量

第 5485 行

std.os.windows.DWORD

类型

第 4064 行

std.os.windows.DWORD_PTR

别名

第 4061 行

别名目标 std.os.windows.ULONG_PTR

std.os.windows.DWORD64

类型

第 4065 行

std.os.windows.ENABLE_VIRTUAL_TERMINAL_PROCESSING

常量

第 4514 行

std.os.windows.eqlIgnoreCaseWtf16

函数

第 3751 行

以等同于启用大小写不敏感比较的 RtlEqualUnicodeString 的方式,比较两个 WTF16 字符串。 此函数可在任何目标上调用。

pub fn eqlIgnoreCaseWtf16(a: []const u16, b: []const u16) bool

参数

a: []const u16
b: []const u16

std.os.windows.eqlIgnoreCaseWtf8

函数

第 3780 行

以等同于启用大小写不敏感比较的 RtlEqualUnicodeString 的方式,比较两个 WTF-8 字符串。 此函数可在任何目标上调用。 假定 a 和 b 均为有效 WTF-8。

pub fn eqlIgnoreCaseWtf8(a: []const u8, b: []const u8) bool

参数

a: []const u8
b: []const u8

std.os.windows.ERESOURCE

容器

第 3518 行

std.os.windows.errorBug

函数

第 4011 行

pub fn errorBug(err: Win32Error) UnexpectedError

参数

err: Win32Error

std.os.windows.EVENT_TYPE

容器

第 3555 行

字段

Notification
Synchronization

std.os.windows.EXCEPTION_ACCESS_VIOLATION

常量

第 4588 行

std.os.windows.EXCEPTION_CONTINUE_SEARCH

常量

第 4591 行

std.os.windows.EXCEPTION_DATATYPE_MISALIGNMENT

常量

第 4587 行

std.os.windows.EXCEPTION_DISPOSITION

类型

第 4993 行

std.os.windows.EXCEPTION_ILLEGAL_INSTRUCTION

常量

第 4589 行

std.os.windows.EXCEPTION_POINTERS

容器

第 4986 行

字段

ExceptionRecord: *EXCEPTION_RECORD
ContextRecord: *CONTEXT

std.os.windows.EXCEPTION_RECORD

容器

第 4593 行

字段

ExceptionCode: u32
ExceptionFlags: u32
ExceptionRecord: *EXCEPTION_RECORD
ExceptionAddress: *anyopaque
NumberParameters: u32
ExceptionInformation: [15]usize

std.os.windows.EXCEPTION_REGISTRATION_RECORD

容器

第 5079 行

字段

std.os.windows.EXCEPTION_ROUTINE

类型

第 4994 行

std.os.windows.EXCEPTION_STACK_OVERFLOW

常量

第 4590 行

std.os.windows.FARPROC

类型

第 4043 行

std.os.windows.FILE

命名空间

第 169 行

std.os.windows.FILE_BOTH_DIR_INFORMATION

容器

第 5440 行

字段

NextEntryOffset: ULONG
FileIndex: ULONG
CreationTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
LastWriteTime: LARGE_INTEGER
ChangeTime: LARGE_INTEGER
EndOfFile: LARGE_INTEGER
AllocationSize: LARGE_INTEGER
FileAttributes: FILE.ATTRIBUTE
FileNameLength: ULONG
EaSize: ULONG
ShortNameLength: CHAR
ShortName: [12]WCHAR
FileName: [1]WCHAR

std.os.windows.FILE_BOTH_DIRECTORY_INFORMATION

别名

第 5456 行

别名目标 std.os.windows.FILE_BOTH_DIR_INFORMATION

std.os.windows.FILE_DIRECTORY_INFORMATION

容器

第 5426 行

字段

NextEntryOffset: ULONG
FileIndex: ULONG
CreationTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
LastWriteTime: LARGE_INTEGER
ChangeTime: LARGE_INTEGER
EndOfFile: LARGE_INTEGER
AllocationSize: LARGE_INTEGER
FileAttributes: FILE.ATTRIBUTE
FileNameLength: ULONG
FileName: [1]WCHAR

std.os.windows.FILE.ACCESS_INFORMATION

容器

第 440 行

字段

AccessFlags: ACCESS_MASK

std.os.windows.FILE.ALIGNMENT_INFORMATION

容器

第 176 行

字段

AlignmentRequirement: ULONG

std.os.windows.FILE.ALL_INFORMATION

容器

第 420 行

字段

BasicInformation: BASIC_INFORMATION
StandardInformation: STANDARD_INFORMATION
InternalInformation: INTERNAL_INFORMATION
EaInformation: EA_INFORMATION
AccessInformation: ACCESS_INFORMATION
PositionInformation: POSITION_INFORMATION
ModeInformation: MODE.INFORMATION
AlignmentInformation: ALIGNMENT_INFORMATION
NameInformation: NAME_INFORMATION

std.os.windows.FILE.ATTRIBUTE

容器

第 655 行

字段

READONLY: bool = false

文件为只读。应用程序可以读取文件,但不能写入或删除。

HIDDEN: bool = false

此文件为隐藏文件。不要将其包含在普通目录列表中。

SYSTEM: bool = false

此文件是操作系统的一部分,或由操作系统独占使用。

Reserved3: u1 = 0
DIRECTORY: bool = false
ARCHIVE: bool = false

应归档此文件。应用程序使用此属性标记待备份或移除的文件。

DEVICE: bool = false
NORMAL: bool = false

文件没有设置其他属性。此属性仅在单独使用时有效。

TEMPORARY: bool = false

文件正被用作临时存储。

SPARSE_FILE: bool = false
REPARSE_POINT: bool = false
COMPRESSED: bool = false
OFFLINE: bool = false

文件数据无法立即取得。此属性表示文件数据已物理移动到脱机存储。 分层存储管理软件 Remote Storage 使用此属性。应用程序不应随意更改它。

NOT_CONTENT_INDEXED: bool = false
ENCRYPTED: bool = false

文件或目录已加密。对于文件,表示全部文件数据均已加密;对于目录,表示新创建的文件与子目录默认加密。更多信息参见“文件加密”。

若同时指定 SYSTEM,此标志无效。

Windows 的 Home、Home Premium、Starter 或 ARM 版本不支持此标志。

INTEGRITY_STREAM: bool = false
VIRTUAL: bool = false
NO_SCRUB_DATA: bool = false
EA_or_RECALL_ON_OPEN: bool = false
PINNED: bool = false
UNPINNED: bool = false
Reserved21: u1 = 0
RECALL_ON_DATA_ACCESS: bool = false
Reserved23: u6 = 0
STRICTLY_SEQUENTIAL: bool = false
Reserved30: u2 = 0

std.os.windows.FILE.ATTRIBUTE_TAG_INFO

容器

第 632 行

字段

FileAttributes: DWORD
ReparseTag: IO_REPARSE_TAG

std.os.windows.FILE.BASIC_INFORMATION

容器

第 595 行

字段

CreationTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
LastWriteTime: LARGE_INTEGER
ChangeTime: LARGE_INTEGER
FileAttributes: ATTRIBUTE

std.os.windows.FILE.CREATE_DISPOSITION

容器

第 701 行

定义创建处置方式的取值

字段

SUPERSEDE = 0x00000000

若文件已存在,则用给定文件替换;若不存在,则创建给定文件。

OPEN = 0x00000001

若文件已存在,则打开它而不创建新文件。 若不存在,则使请求失败,不创建文件。

CREATE = 0x00000002

若文件已存在,则使请求失败,不创建也不打开指定文件。若不存在,则创建。

OPEN_IF = 0x00000003

如果文件已存在,则打开;如果不存在,则创建给定文件。

OVERWRITE = 0x00000004

如果文件已存在,则打开并覆盖;如果不存在,则使请求失败。

OVERWRITE_IF = 0x00000005

若文件已存在,则打开并覆盖它;若不存在,则创建给定文件。

std.os.windows.FILE.CREATE_DISPOSITION.MAXIMUM_DISPOSITION

常量

第 717 行

CREATE_DISPOSITION

std.os.windows.FILE.DISPOSITION

容器

第 185 行

字段

DELETE: bool = false
POSIX_SEMANTICS: bool = false
FORCE_IMAGE_SECTION_CHECK: bool = false
ON_CLOSE: bool = false
IGNORE_READONLY_ATTRIBUTE: bool = false
Reserved5: u27 = 0

std.os.windows.FILE.DISPOSITION.DO_NOT_DELETE

常量

第 193 行

DISPOSITION

std.os.windows.FILE.DISPOSITION.INFORMATION

容器

第 195 行

字段

DeleteFile: BOOLEAN

std.os.windows.FILE.DISPOSITION.INFORMATION.EX

容器

第 198 行

字段

Flags: DISPOSITION

std.os.windows.FILE.EA_INFORMATION

容器

第 436 行

字段

EaSize: ULONG

std.os.windows.FILE.END_OF_FILE_INFORMATION

容器

第 172 行

字段

EndOfFile: LARGE_INTEGER

std.os.windows.FILE.FS_DEVICE_INFORMATION

容器

第 623 行

字段

DeviceType: DEVICE_TYPE
Characteristics: ULONG

std.os.windows.FILE.FS_VOLUME_INFORMATION

容器

第 204 行

字段

VolumeCreationTime: LARGE_INTEGER
VolumeSerialNumber: ULONG
VolumeLabelLength: ULONG
SupportsObjects: BOOLEAN
VolumeLabel: [0]WCHAR

std.os.windows.FILE.FS_VOLUME_INFORMATION.getVolumeLabel

函数

第 211 行

pub fn getVolumeLabel(fvi: *const FS_VOLUME_INFORMATION) []const WCHAR

参数

fvi: *const FS_VOLUME_INFORMATION

std.os.windows.FILE.FULL_EA_INFORMATION

容器

第 615 行

字段

NextEntryOffset: ULONG
Flags: UCHAR
EaNameLength: UCHAR
EaValueLength: USHORT
EaName: [0]CHAR

std.os.windows.FILE.INFORMATION_CLASS

容器

第 506 行

字段

Directory = 1
FullDirectory = 2
BothDirectory = 3
Basic = 4
Standard = 5
Internal = 6
Ea = 7
Access = 8
Name = 9
Rename = 10
Link = 11
Names = 12
Disposition = 13
Position = 14
FullEa = 15
Mode = 16
Alignment = 17
All = 18
Allocation = 19
EndOfFile = 20
AlternateName = 21
Stream = 22
Pipe = 23
PipeLocal = 24
PipeRemote = 25
MailslotQuery = 26
MailslotSet = 27
Compression = 28
ObjectId = 29
Completion = 30
MoveCluster = 31
Quota = 32
ReparsePoint = 33
NetworkOpen = 34
AttributeTag = 35
Tracking = 36
IdBothDirectory = 37
IdFullDirectory = 38
ValidDataLength = 39
ShortName = 40
IoCompletionNotification = 41
IoStatusBlockRange = 42
IoPriorityHint = 43
SfioReserve = 44
SfioVolume = 45
HardLink = 46
ProcessIdsUsingFile = 47
NormalizedName = 48
NetworkPhysicalName = 49
IdGlobalTxDirectory = 50
IsRemoteDevice = 51
Unused = 52
NumaNode = 53
StandardLink = 54
RemoteProtocol = 55
RenameBypassAccessCheck = 56
LinkBypassAccessCheck = 57
VolumeName = 58
Id = 59
IdExtdDirectory = 60
ReplaceCompletion = 61
HardLinkFullId = 62
IdExtdBothDirectory = 63
DispositionEx = 64
RenameEx = 65
RenameExBypassAccessCheck = 66
DesiredStorageClass = 67
Stat = 68
MemoryPartition = 69
StatLx = 70
CaseSensitive = 71
LinkEx = 72
LinkExBypassAccessCheck = 73
StorageReserveId = 74
CaseSensitiveForceAccessCheck = 75
KnownFolder = 76
StatBasic = 77
Id64ExtdDirectory = 78
Id64ExtdBothDirectory = 79
IdAllExtdDirectory = 80
IdAllExtdBothDirectory = 81
StreamReservation = 82
MupProvider = 83
_

std.os.windows.FILE.INFORMATION_CLASS.Maximum

常量

第 592 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.FILE.INTERNAL_INFORMATION

容器

第 432 行

字段

IndexNumber: LARGE_INTEGER

std.os.windows.FILE.MODE

容器

第 721 行

定义创建或打开选项的标志

字段

DIRECTORY_FILE: bool = false

正在创建或打开的文件是目录文件。使用此标志时,CreateDisposition 参数必须设为 .CREATE、.FILE_OPEN 或 .OPEN_IF。 此时,其他兼容的 CreateOptions 标志仅包括 SYNCHRONOUS_IO、WRITE_THROUGH、OPEN_FOR_BACKUP_INTENT 和 OPEN_BY_FILE_ID。

WRITE_THROUGH: bool = false

写入数据的应用程序必须先实际将数据传输到文件中, 之后才能将请求的写入操作视为完成。 若设置 CreateOptions 标志 NO_INTERMEDIATE_BUFFERING, 则会自动设置此标志。

SEQUENTIAL_ONLY: bool = false

对文件的所有访问都是顺序访问。

NO_INTERMEDIATE_BUFFERING: bool = false

文件不能被缓存在驱动内部 缓冲区中。此标志与 DesiredAccess 的 FILE_APPEND_DATA 标志不兼容。

IO: enum(u2) {
    /// 对文件的所有操作均异步执行。
    ASYNCHRONOUS = 0b00,
    /// 对此文件的所有操作都同步执行。代表调用方
    /// 进行的任何等待都可能被警报
    /// 提前终止。此标志还使输入输出系统
    /// 维护文件位置上下文。若设置此标志,
    /// 还必须在 DesiredAccess 中设置 `SYNCHRONIZE` 标志。
    SYNCHRONOUS_ALERT = 0b01,
    /// 文件上的全部操作均同步执行。系统中用于同步 I/O 排队和完成的等待不可被警醒。
    /// 此标志还会使 I/O 系统维护文件位置上下文。
    /// 若设置此标志,还必须设置 DesiredAccess 的 `SYNCHRONIZE` 标志。
    ///
    ///
    SYNCHRONOUS_NONALERT = 0b10,
    _,

    pub const VALID_FLAGS: @This() = @fromBackingInt(@intCast(0b11));
}
NON_DIRECTORY_FILE: bool = false

打开的文件不能是目录文件,否则此调用 失败。打开的文件对象可以表示数据文件、 逻辑设备、虚拟设备、物理设备或卷。

CREATE_TREE_CONNECTION: bool = false

为此文件创建树连接,以通过 网络打开它。设备驱动和中间层驱动不使用此标志。

COMPLETE_IF_OPLOCKED: bool = false

若目标文件已被机会锁锁定,立即以替代成功码 STATUS_OPLOCK_BREAK_IN_PROGRESS 完成操作,而非阻塞调用者线程。 文件已被机会锁锁定表示另一个调用者已经访问该文件。 设备驱动和中间层驱动不使用此标志。

NO_EA_KNOWLEDGE: bool = false

若正在打开的已有文件的扩展属性表明,调用者必须理解扩展属性 EA 才能正确解释文件,则使请求失败,因为调用者不理解如何处理 EA。 此标志与设备驱动和中间层驱动无关。

OPEN_REMOTE_INSTANCE: bool = false
RANDOM_ACCESS: bool = false

文件可能被随机访问,因此文件系统驱动程序或系统不应对文件执行顺序预读。

DELETE_ON_CLOSE: bool = false

当该文件最后一个句柄传入 NtClose 时删除文件。 若设置此标志,则 DesiredAccess 参数中必须设置 DELETE。

OPEN_BY_FILE_ID: bool = false

ObjectAttributes 参数指定的文件名 包含文件的 8 字节文件引用编号。此编号 由具体文件系统分配,且为该文件系统所特有。 如果文件是重解析点,文件名还会包含 设备名称。注意,FAT 文件系统不支持此 标志。设备驱动程序及中间驱动程序不使用此标志。

OPEN_FOR_BACKUP_INTENT: bool = false

文件以备份意图打开。因此,系统 应先检查特定访问权限并授予调用方 适当的文件访问权限,然后才根据文件的安全描述符检查 DesiredAccess 参数。设备驱动程序和中间驱动程序 不使用此标志。

NO_COMPRESSION: bool = false

禁止从父目录继承 FILE_ATTRIBUTE.COMPRESSED。 这样可在标记为压缩的目录中 创建非压缩文件。

OPEN_REQUIRING_OPLOCK: bool = false

以单次原子操作打开文件并请求 该文件的机会锁。文件系统 在执行创建操作之前检查机会锁;如果 操作会破坏已有机会锁,则以 STATUS_CANNOT_BREAK_OPLOCK 返回码使创建失败。更多 信息见备注部分。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP 不支持此标志。

以下文件系统支持此标志:NTFS、FAT 和 exFAT。

Reserved17: u3 = 0
RESERVE_OPFILTER: bool = false

此标志允许应用程序请求筛选型机会 锁,以防止其他应用程序遇到共享冲突。 如果已有打开的句柄,创建请求将 以 STATUS_OPLOCK_NOT_GRANTED 失败。更多信息请参见 备注部分。

OPEN_REPARSE_POINT: bool = false

打开带重解析点的文件,并绕过该文件的常规 重解析点处理。更多信息参见备注 部分。

OPEN_NO_RECALL: bool = false

指示执行脱机存储或 虚拟化的所有过滤器,不要因本次打开 而回迁文件内容。

OPEN_FOR_FREE_SPACE_QUERY: bool = false

此标志指示文件系统捕获与调用线程关联 的用户。之后使用返回句柄调用 FltQueryVolumeInformation 或 ZwQueryVolumeInformationFile 时, 在计算调用方可用空闲空间时,将采用 捕获的用户身份,而不是 调用发生时的用户身份。这适用于以下 FsInformationClass 值:FileFsSizeInformation、 FileFsFullSizeInformation 和 FileFsFullSizeInformationEx。

Reserved24: u8 = 0

std.os.windows.FILE.MODE.INFORMATION

容器

第 883 行

字段

Mode: MODE

指定文件访问模式的一组标志。 这些标志是 MODE 的子集。

std.os.windows.FILE.MODE.VALID_FLAGS

常量

第 756 行

@This()

std.os.windows.FILE.MODE.VALID_MAILSLOT_OPTION_FLAGS

常量

第 870 行

MODE

std.os.windows.FILE.MODE.VALID_OPTION_FLAGS

常量

第 841 行

MODE

std.os.windows.FILE.MODE.VALID_PIPE_OPTION_FLAGS

常量

第 865 行

MODE

std.os.windows.FILE.MODE.VALID_SET_OPTION_FLAGS

常量

第 875 行

MODE

std.os.windows.FILE.NAME_FLAGS

容器

第 218 行

字段

NTFS: bool = false
DOS: bool = false
Reserved2: u5 = 0
UNSPECIFIED: bool = false

std.os.windows.FILE.NAME_INFORMATION

容器

第 180 行

字段

FileNameLength: ULONG
FileName: [1]WCHAR

std.os.windows.FILE.NOTIFY

命名空间

第 225 行

std.os.windows.FILE.NOTIFY.CHANGE

容器

第 226 行

字段

FILE_NAME: bool = false
DIR_NAME: bool = false
ATTRIBUTES: bool = false
SIZE: bool = false
LAST_WRITE: bool = false
LAST_ACCESS: bool = false
CREATION: bool = false
EA: bool = false
SECURITY: bool = false
STREAM_NAME: bool = false
STREAM_SIZE: bool = false
STREAM_WRITE: bool = false
Reserved12: u20 = 0

std.os.windows.FILE.NOTIFY.EXTENDED_INFORMATION

容器

第 254 行

字段

NextEntryOffset: ULONG
Action: ULONG
CreationTime: LARGE_INTEGER
LastModificationTime: LARGE_INTEGER
LastChangeTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
AllocatedLength: LARGE_INTEGER
FileSize: LARGE_INTEGER
FileAttributes: ATTRIBUTE
u: extern union {
    ReparsePointTag: ULONG,
    EaSize: ULONG,
}
FileId: LARGE_INTEGER
ParentFileId: LARGE_INTEGER
FileNameLength: ULONG
FileName: [0]WCHAR

std.os.windows.FILE.NOTIFY.EXTENDED_INFORMATION.fileName

函数

第 273 行

pub fn fileName(info: *INFORMATION) []WCHAR

参数

info: *INFORMATION

std.os.windows.FILE.NOTIFY.FULL_INFORMATION

容器

第 279 行

字段

NextEntryOffset: ULONG
Action: ULONG
CreationTime: LARGE_INTEGER
LastModificationTime: LARGE_INTEGER
LastChangeTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
AllocatedLength: LARGE_INTEGER
FileSize: LARGE_INTEGER
FileAttributes: ATTRIBUTE
u: extern union {
    ReparsePointTag: ULONG,
    EaSize: ULONG,
}
FileId: LARGE_INTEGER
ParentFileId: LARGE_INTEGER
FileNameLength: ULONG
FileNameFlags: NAME_FLAGS
FileName: [0]WCHAR

std.os.windows.FILE.NOTIFY.FULL_INFORMATION.fileName

函数

第 299 行

pub fn fileName(info: *INFORMATION) []WCHAR

参数

info: *INFORMATION

std.os.windows.FILE.NOTIFY.INFORMATION

容器

第 242 行

字段

NextEntryOffset: ULONG
Action: ULONG
FileNameLength: ULONG
FileName: [0]WCHAR

std.os.windows.FILE.NOTIFY.INFORMATION.fileName

函数

第 248 行

pub fn fileName(info: *INFORMATION) []WCHAR

参数

info: *INFORMATION

std.os.windows.FILE.PIPE

命名空间

第 306 行

std.os.windows.FILE.PIPE.COMPLETION_MODE

容器

第 326 行

定义 NtCreateNamedPipeFile 的 CompletionMode 标志

字段

OPERATION: enum(u1) {
    QUEUE = 0b0,
    COMPLETE = 0b1,
} = .QUEUE
Reserved1: u31 = 0

std.os.windows.FILE.PIPE.CONFIGURATION

容器

第 344 行

定义 NtQueryInformationFile 的 NamedPipeConfiguration 标志

字段

INBOUND = 0x00000000
OUTBOUND = 0x00000001
FULL_DUPLEX = 0x00000002

std.os.windows.FILE.PIPE.END

容器

第 359 行

为 NtQueryInformationFile 定义 NamedPipeEnd 标志。

字段

CLIENT = 0x00000000
SERVER = 0x00000001

std.os.windows.FILE.PIPE.INFORMATION

容器

第 364 行

字段

ReadMode: READ_MODE
CompletionMode: COMPLETION_MODE

std.os.windows.FILE.PIPE.LOCAL_INFORMATION

容器

第 369 行

字段

NamedPipeType: TYPE
NamedPipeConfiguration: CONFIGURATION
MaximumInstances: ULONG
CurrentInstances: ULONG
InboundQuota: ULONG
ReadDataAvailable: ULONG
OutboundQuota: ULONG
WriteQuotaAvailable: ULONG
NamedPipeState: STATE
NamedPipeEnd: END

std.os.windows.FILE.PIPE.READ_MODE

容器

第 335 行

为 NtCreateNamedPipeFile 定义 ReadMode 标志。

字段

MODE: enum(u1) {
    BYTE_STREAM = 0b0,
    MESSAGE = 0b1,
}
Reserved1: u31 = 0

std.os.windows.FILE.PIPE.REMOTE_INFORMATION

容器

第 382 行

字段

CollectDataTime: LARGE_INTEGER
MaximumCollectionCount: ULONG

std.os.windows.FILE.PIPE.STATE

容器

第 351 行

为 NtQueryInformationFile 定义 NamedPipeState 标志。

字段

DISCONNECTED = 0x00000001
LISTENING = 0x00000002
CONNECTED = 0x00000003
CLOSING = 0x00000004

std.os.windows.FILE.PIPE.TYPE

容器

第 308 行

定义 NtCreateNamedPipeFile 的 NamedPipeType 标志

字段

TYPE: enum(u1) {
    BYTE_STREAM = 0b0,
    MESSAGE = 0b1,
} = .BYTE_STREAM
REMOTE_CLIENTS: enum(u1) {
    ACCEPT = 0b0,
    REJECT = 0b1,
} = .ACCEPT
Reserved2: u30 = 0

std.os.windows.FILE.PIPE.TYPE.VALID_MASK

常量

第 319 行

TYPE

std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER

容器

第 387 行

字段

Timeout: LARGE_INTEGER
NameLength: ULONG
TimeoutSpecified: BOOLEAN
Name: [PATH_MAX_WIDE]WCHAR

std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.getName

函数

第 409 行

pub fn getName(fpwfb: *const WAIT_FOR_BUFFER) []const WCHAR

参数

fpwfb: *const WAIT_FOR_BUFFER

std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.init

函数

第 395 行

pub fn init(opts: struct { Timeout: ?LARGE_INTEGER = null, Name: []const WCHAR, }) WAIT_FOR_BUFFER

参数

opts: struct {
    Timeout: ?LARGE_INTEGER = null,
    Name: []const WCHAR,
}

std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.toBuffer

函数

第 413 行

pub fn toBuffer(fpwfb: *const WAIT_FOR_BUFFER) []const u8

参数

fpwfb: *const WAIT_FOR_BUFFER

std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.WAIT_FOREVER

常量

第 393 行

LARGE_INTEGER

std.os.windows.FILE.POSITION_INFORMATION

容器

第 611 行

字段

CurrentByteOffset: LARGE_INTEGER

std.os.windows.FILE.RENAME_INFORMATION

容器

第 448 行

没有将其拆分为 RENAME_INFORMATION 和 RENAME_INFORMATION_EX,因为 两者的唯一区别是 Flags 类型(_EX 之前为 BOOLEAN,_EX 中为 ULONG), 这不会影响结构布局;RootDirectory 的偏移量无论如何都相同。

字段

Flags: FLAGS
RootDirectory: ?HANDLE
FileNameLength: ULONG
FileName: [PATH_MAX_WIDE]WCHAR

std.os.windows.FILE.RENAME_INFORMATION.FLAGS

容器

第 469 行

字段

REPLACE_IF_EXISTS: bool = false
POSIX_SEMANTICS: bool = false
SUPPRESS_PIN_STATE_INHERITANCE: bool = false
SUPPRESS_STORAGE_RESERVE_INHERITANCE: bool = false
AVAILABLE_SPACE: enum(u2) {
    NO_PRESERVE = 0b00,
    NO_INCREASE = 0b01,
    NO_DECREASE = 0b10,
    PRESERVE = 0b11,
} = .NO_PRESERVE
IGNORE_READONLY_ATTRIBUTE: bool = false
RESIZE_SR: enum(u2) {
    NO_FORCE = 0b00,
    FORCE_TARGET = 0b01,
    FORCE_SOURCE = 0b10,
    FORCE = 0b11,
} = .NO_FORCE
Reserved9: u23 = 0

std.os.windows.FILE.RENAME_INFORMATION.getFileName

函数

第 490 行

pub fn getFileName(ri: *const RENAME_INFORMATION) []const WCHAR

参数

ri: *const RENAME_INFORMATION

std.os.windows.FILE.RENAME_INFORMATION.init

函数

第 454 行

pub fn init(opts: struct { Flags: FLAGS = .{}, RootDirectory: ?HANDLE = null, FileName: []const WCHAR, }) RENAME_INFORMATION

参数

opts: struct {
    Flags: FLAGS = .{},
    RootDirectory: ?HANDLE = null,
    FileName: []const WCHAR,
}

std.os.windows.FILE.RENAME_INFORMATION.toBuffer

函数

第 494 行

pub fn toBuffer(fri: *RENAME_INFORMATION) []u8

参数

std.os.windows.FILE.SHARE

容器

第 639 行

字段

READ: bool = false

其他线程可打开此文件进行读取访问。

WRITE: bool = false

其他线程可打开该文件以获取写入访问权限。

DELETE: bool = false

其他线程可打开该文件以获取删除访问权限。

Reserved3: u29 = 0

std.os.windows.FILE.SHARE.VALID_FLAGS

常量

第 648 行

SHARE

std.os.windows.FILE.STANDARD_INFORMATION

容器

第 603 行

字段

AllocationSize: LARGE_INTEGER
EndOfFile: LARGE_INTEGER
NumberOfLinks: ULONG
DeletePending: BOOLEAN
Directory: BOOLEAN

std.os.windows.FILE.USE_FILE_POINTER_POSITION

常量

第 628 行

std.os.windows.FileInformationIterator

类型函数

第 5460 行

用于遍历 FILE_*_INFORMATION 结构体字节缓冲区的辅助函数(如 NtQueryDirectoryFile 调用的结果)。

pub fn FileInformationIterator(comptime FileInformationType: type) type

参数

FileInformationType: type

字段

byte_offset: usize = 0
buf: []u8 align(@alignOf(FileInformationType))

std.os.windows.FileInformationIterator.next

函数

第 5465 行

pub fn next(self: *@This()) ?*FileInformationType

参数

self: *@This()

std.os.windows.FILETIME

容器

第 4213 行

字段

dwLowDateTime: DWORD
dwHighDateTime: DWORD

std.os.windows.FLOAT

类型

第 4030 行

std.os.windows.FLOATING_SAVE_AREA

类型

第 4602 行

std.os.windows.FLS_CALLBACK_INFO

容器

第 5025 行

std.os.windows.FOREGROUND_BLUE

常量

第 4517 行

std.os.windows.FOREGROUND_GREEN

常量

第 4518 行

std.os.windows.FOREGROUND_INTENSITY

常量

第 4520 行

std.os.windows.FOREGROUND_RED

常量

第 4519 行

std.os.windows.fromSysTime

函数

第 3732 行

文件时间是一个 64 位值,表示自协调世界时 (UTC)1601 年 1 月 1 日零点起 经过的 100 纳秒时间间隔数量。 此函数返回自标准纪元起的纳秒数, 采用 POSIX 纪元(公元 1970 年 1 月 1 日)。

pub fn fromSysTime(hns: i64) Io.Timestamp

参数

hns: i64

std.os.windows.FS_INFORMATION_CLASS

容器

第 3349 行

字段

Volume = 1
Label = 2
Size = 3
Device = 4
Attribute = 5
Control = 6
FullSize = 7
ObjectId = 8
DriverPath = 9
VolumeFlags = 10
SectorSize = 11
DataCopy = 12
MetadataSize = 13
FullSizeEx = 14
Guid = 15
_

std.os.windows.FS_INFORMATION_CLASS.Maximum

常量

第 3367 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.GetCurrentProcess

函数

第 3582 行

pub fn GetCurrentProcess() HANDLE

std.os.windows.GetCurrentProcessId

函数

第 3587 行

pub fn GetCurrentProcessId() DWORD

std.os.windows.GetCurrentThread

函数

第 3591 行

pub fn GetCurrentThread() HANDLE

std.os.windows.GetCurrentThreadId

函数

第 3596 行

pub fn GetCurrentThreadId() DWORD

std.os.windows.GetLastError

函数

第 3600 行

pub fn GetLastError() Win32Error

std.os.windows.GetProcessHeap

函数

第 3576 行

pub fn GetProcessHeap() ?*HEAP

std.os.windows.getSystemDirectoryWtf16Le

函数

第 6023 行

返回系统目录路径,通常为 "C:\WINDOWS\System32"。

等同于 kernel32 中的 GetSystemDirectoryW。

pub fn getSystemDirectoryWtf16Le() [:0]const u16

std.os.windows.GUID

容器

第 4218 行

字段

Data1: u32
Data2: u16
Data3: u16
Data4: [8]u8

std.os.windows.GUID.format

函数

第 4260 行

pub fn format(self: GUID, w: *std.Io.Writer) std.Io.Writer.Error!void

参数

self: GUID
w: *std.Io.Writer

错误

WriteFailed

详细诊断信息见 Writer 实现。

用法示例

test format {
    const guid0: GUID = .{ .Data1 = 1, .Data2 = 1, .Data3 = 1, .Data4 = .{ 0, 1, 0, 0, 0, 0, 0, 1 } };
    try std.testing.expectFmt("{00000001-0001-0001-0001-000000000001}", "{f}", .{guid0});

    const guid1: GUID = .parse("{01234567-89AB-EF10-3254-7698badcfe91}");
    try std.testing.expectFmt("{01234567-89ab-ef10-3254-7698badcfe91}", "{f}", .{guid1});
}

std.os.windows.GUID.hex_offsets

常量

第 4224 行

[16]u6

std.os.windows.GUID.parse

函数

第 4231 行

pub fn parse(s: []const u8) GUID

参数

s: []const u8

用法示例

test parse {
    const expected: GUID = .{
        .Data1 = 0x01234567,
        .Data2 = 0x89ab,
        .Data3 = 0xef10,
        .Data4 = "\x32\x54\x76\x98\xba\xdc\xfe\x91".*,
    };
    try std.testing.expectEqual(expected, GUID.parse("{01234567-89AB-EF10-3254-7698badcfe91}"));
}

std.os.windows.GUID.parseNoBraces

函数

第 4237 行

pub fn parseNoBraces(s: []const u8) !GUID

参数

s: []const u8

std.os.windows.HANDLE

类型

第 4031 行

std.os.windows.hasCommonNtPrefix

函数

第 3914 行

若路径以 \??\ 开头,则返回 true。这通常表示 NT 路径,但不足以完全区分 NT 路径与 Win32 路径,因为 \??\ 实际上不是独立前缀,而是对象管理器中特殊虚拟文件夹的路径。

例如,\Device\HarddiskVolume2 和 \DosDevices\C: 也是 NT 路径,但无法仅通过前缀识别。

因此,推断路径是 NT 路径还是 Win32 路径通常是错误做法,应当提前明确该信息。

若 T 为 u16,则 path 应采用 WTF-16LE 编码。

pub fn hasCommonNtPrefix(comptime T: type, path: []const T) bool

参数

T: type
path: []const T

std.os.windows.HBRUSH

类型

第 4034 行

std.os.windows.HCRYPTPROV

别名

第 4032 行

别名目标 std.os.windows.ULONG_PTR

std.os.windows.HCURSOR

类型

第 4035 行

std.os.windows.HDC

类型

第 4041 行

std.os.windows.HEAP

容器

第 1944 行

std.os.windows.HEAP.FLAGS

容器

第 1945 行

字段

NO_SERIALIZE: bool = false

堆函数访问此堆时,不进行串行化访问控制。此选项适用于所有后续堆函数调用,也可仅在单次堆函数调用时指定。

使用此选项创建的堆无法启用低碎片堆 LFH。

使用此选项创建的堆无法锁定。

GROWABLE: bool = false

指定堆可增长。若 HeapBase 为 NULL,则必须指定。

GENERATE_EXCEPTIONS: bool = false

调用 HeapAlloc 和 HeapReAlloc 失败时,例如内存不足, 系统会引发异常,而非返回 NULL。

为确保全部分配函数调用都会生成异常,应指定 GENERATE_EXCEPTIONS 于 HeapCreate 调用。此时无需 再在各分配函数调用中额外指定 GENERATE_EXCEPTIONS。

ZERO_MEMORY: bool = false

分配的内存将初始化为零。 否则,内存不会初始化为零。

REALLOC_IN_PLACE_ONLY: bool = false
TAIL_CHECKING_ENABLED: bool = false
FREE_CHECKING_ENABLED: bool = false
DISABLE_COALESCE_ON_FREE: bool = false

std.os.windows.HEAP.FLAGS.ALLOCATION

容器

第 2042 行

字段

COMMON: FLAGS = .{}
SETTABLE_USER: packed struct(u4) {
    VALUE: u1 = 0,
    FLAGS: packed struct(u3) {
        FLAG1: bool = false,
        FLAG2: bool = false,
        FLAG3: bool = false,
    } = .{},
} = .{}
CLASS: CLASS = @fromBackingInt(@intCast(0))
Reserved16: u2 = 0
TAG: u12 = 0
Reserved30: u2 = 0

std.os.windows.HEAP.FLAGS.CLASS

容器

第 1971 行

字段

PROCESS

进程堆

PRIVATE

私有堆

KERNEL

内核堆

GDI

GDI 堆

USER

用户堆

CONSOLE

控制台堆

USER_DESKTOP

用户桌面堆

CSRSS_SHARED

Csrss 共享堆

CSR_PORT

Csr 端口堆

_

std.os.windows.HEAP.FLAGS.CLASS.MASK

常量

第 1992 行

CLASS

std.os.windows.HEAP.FLAGS.CREATE

容器

第 1995 行

字段

COMMON: FLAGS = .{}
SEGMENT_HEAP: bool = false
HARDENED: bool = false

仅适用于段堆。应用指针混淆,通常 过度且无必要,但对 win32k 中某些不安全的 堆是必需的。

指定 HEAP_CREATE_HARDENED 会阻止堆使用锁, 因为锁变量可能在堆元数据中暴露指针。 因此,调用方负责同步对强化堆的访问。

Reserved10: u2 = 0
CLASS: CLASS = @fromBackingInt(@intCast(0))
ALIGN_16: bool = false

创建按 16 字节对齐的堆(已废弃)

ENABLE_TRACING: bool = false

已启用创建堆调用跟踪(已过时)

ENABLE_EXECUTE: bool = false

创建带可执行页的堆。

若硬件强制执行数据执行保护,从此堆分配的全部内存块仍允许执行代码。需要从堆执行代码的应用程序应使用此堆标志。 若未指定 ENABLE_EXECUTE,应用程序又尝试从受保护页执行代码,则会收到状态码为 STATUS_ACCESS_VIOLATION 的异常。

Reserved19: u13 = 0

std.os.windows.HEAP.FLAGS.CREATE.VALID_MASK

常量

第 2022 行

CREATE

std.os.windows.HEAP.RTL_PARAMETERS

容器

第 2059 行

字段

Length: ULONG
SegmentReserve: SIZE_T
SegmentCommit: SIZE_T
DeCommitFreeBlockThreshold: SIZE_T
DeCommitTotalFreeThreshold: SIZE_T
MaximumAllocationSize: SIZE_T
VirtualMemoryThreshold: SIZE_T
InitialCommit: SIZE_T
InitialReserve: SIZE_T
CommitRoutine: *const COMMIT_ROUTINE
Reserved: [2]SIZE_T = @splat(0)

std.os.windows.HEAP.RTL_PARAMETERS.COMMIT_ROUTINE

常量

第 2072 行

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT

容器

第 2078 行

字段

Version: VERSION
Size: USHORT
Flags: FLG
MemorySource: MEMORY_SOURCE
Reserved: [4]SIZE_T

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.FLG

容器

第 2090 行

字段

USE_PAGE_HEAP: bool = false
NO_LFH: bool = false
Reserved2: u30 = 0

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.FLG.VALID_FLAGS

常量

第 2095 行

FLG

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE

容器

第 2101 行

字段

Flags: ULONG
MemoryTypeMask: TYPE
NumaNode: ULONG
u: extern union {
    PartitionHandle: HANDLE,
    Callbacks: *const VA_CALLBACKS,
}
Reserved: [2]SIZE_T = @splat(0)

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.TYPE

容器

第 2111 行

字段

Paged
NonPaged
@"64KPage"
LargePage
HugePage
Custom
_

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.TYPE.Max

常量

第 2120 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS

容器

第 2123 行

字段

CallbackContext: HANDLE
AllocateVirtualMemory: *const ALLOCATE_VIRTUAL_MEMORY_EX_CALLBACK
FreeVirtualMemory: *const FREE_VIRTUAL_MEMORY_EX_CALLBACK
QueryVirtualMemory: *const QUERY_VIRTUAL_MEMORY_CALLBACK

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.ALLOCATE_VIRTUAL_MEMORY_EX_CALLBACK

常量

第 2129 行

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.FREE_VIRTUAL_MEMORY_EX_CALLBACK

常量

第 2139 行

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.MEMORY_INFO_CLASS

容器

第 2157 行

字段

Basic
_

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.QUERY_VIRTUAL_MEMORY_CALLBACK

常量

第 2147 行

std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.VERSION

容器

第 2085 行

字段

CURRENT = 3
_

std.os.windows.HGLRC

类型

第 4042 行

std.os.windows.HICON

类型

第 4036 行

std.os.windows.HINSTANCE

类型

第 4037 行

std.os.windows.HKEY

类型

第 4315 行

std.os.windows.HKEY_CLASSES_ROOT

常量

第 4317 行

HKEY

std.os.windows.HKEY_CURRENT_CONFIG

常量

第 4324 行

HKEY

std.os.windows.HKEY_CURRENT_USER

常量

第 4318 行

HKEY

std.os.windows.HKEY_CURRENT_USER_LOCAL_SETTINGS

常量

第 4326 行

HKEY

std.os.windows.HKEY_DYN_DATA

常量

第 4325 行

HKEY

std.os.windows.HKEY_LOCAL_MACHINE

常量

第 4319 行

HKEY

std.os.windows.HKEY_PERFORMANCE_DATA

常量

第 4321 行

HKEY

std.os.windows.HKEY_PERFORMANCE_NLSTEXT

常量

第 4323 行

HKEY

std.os.windows.HKEY_PERFORMANCE_TEXT

常量

第 4322 行

HKEY

std.os.windows.HKEY_USERS

常量

第 4320 行

HKEY

std.os.windows.HMENU

类型

第 4038 行

std.os.windows.HMODULE

类型

第 4039 行

std.os.windows.HWND

类型

第 4040 行

std.os.windows.IMAGE_TLS_DIRECTORY

容器

第 4299 行

字段

StartAddressOfRawData: usize
EndAddressOfRawData: usize
AddressOfIndex: usize
AddressOfCallBacks: usize
SizeOfZeroFill: u32
Characteristics: u32

std.os.windows.IMAGE_TLS_DIRECTORY32

别名

第 4308 行

别名目标 std.os.windows.IMAGE_TLS_DIRECTORY

std.os.windows.IMAGE_TLS_DIRECTORY64

别名

第 4307 行

别名目标 std.os.windows.IMAGE_TLS_DIRECTORY

std.os.windows.INIT_ONCE

别名

第 4553 行

别名目标 std.os.windows.RTL_RUN_ONCE

std.os.windows.INIT_ONCE_FN

类型

第 4555 行

std.os.windows.INIT_ONCE_STATIC_INIT

别名

第 4554 行

别名目标 std.os.windows.RTL_RUN_ONCE_INIT

std.os.windows.INT

类型

第 4045 行

std.os.windows.INVALID_FILE_ATTRIBUTES

常量

第 4155 行

DWORD

std.os.windows.INVALID_HANDLE_VALUE

常量

第 4153 行

HANDLE

std.os.windows.Io

别名

第 11 行

别名目标 std.Io

std.os.windows.IO_APC_ROUTINE

常量

第 5478 行

std.os.windows.IO_REPARSE_TAG

容器

第 2403 行

字段

Value: u12
Index: u4 = 0
ReservedBits: u12 = 0
IsDirectory: bool = false

若为目录则可具有子项。

IsSurrogate: bool = false

表示系统中的另一个命名实体。

IsReserved: bool = false

对于非 Microsoft 标签,必须为 false。

IsMicrosoft: bool = false

归 Microsoft 所有。

std.os.windows.IO_REPARSE_TAG.AF_UNIX

常量

第 2450 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.APPEXECLINK

常量

第 2442 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.APPXSTRM

常量

第 2430 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.CLOUD

函数

第 2439 行

pub inline fn CLOUD(index: u4) IO_REPARSE_TAG

参数

index: u4

std.os.windows.IO_REPARSE_TAG.CSV

常量

第 2423 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DATALESS_CIM

常量

第 2458 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DEDUP

常量

第 2429 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DFM

常量

第 2433 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DFS

常量

第 2424 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DFSR

常量

第 2428 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.DRIVE_EXTENDER

常量

第 2419 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.FILE_PLACEHOLDER

常量

第 2432 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.FILTER_MANAGER

常量

第 2425 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.GLOBAL_REPARSE

常量

第 2438 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.HSM

常量

第 2418 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.HSM2

常量

第 2420 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.IIS_CACHE

常量

第 2427 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.LX_BLK

常量

第 2453 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.LX_CHR

常量

第 2452 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.LX_FIFO

常量

第 2451 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.LX_STORAGE_SYNC_FOLDER

常量

第 2454 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.LX_SYMLINK

常量

第 2444 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.MOUNT_POINT

常量

第 2417 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.NFS

常量

第 2431 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.ONEDRIVE

常量

第 2448 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.PROJFS

常量

第 2443 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.PROJFS_TOMBSTONE

常量

第 2449 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.RESERVED_INVALID

常量

第 2416 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.SIS

常量

第 2421 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.STORAGE_SYNC

常量

第 2445 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.SYMLINK

常量

第 2426 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.UNHANDLED

常量

第 2447 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.WCI

函数

第 2435 行

pub inline fn WCI(index: u1) IO_REPARSE_TAG

参数

index: u1

std.os.windows.IO_REPARSE_TAG.WCI_LINK

函数

第 2455 行

pub inline fn WCI_LINK(index: u1) IO_REPARSE_TAG

参数

index: u1

std.os.windows.IO_REPARSE_TAG.WCI_TOMBSTONE

常量

第 2446 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.WIM

常量

第 2422 行

IO_REPARSE_TAG

std.os.windows.IO_REPARSE_TAG.WOF

常量

第 2434 行

IO_REPARSE_TAG

std.os.windows.IO_STATUS_BLOCK

容器

第 4157 行

字段

u: extern union {
    Status: NTSTATUS,
    Pointer: ?*anyopaque,
}
Information: ULONG_PTR

std.os.windows.IOCTL

命名空间

第 2313 行

std.os.windows.IOCTL.AFD

命名空间

第 2314 行

std.os.windows.IOCTL.AFD.ACCEPT

常量

第 2325 行

CTL_CODE

std.os.windows.IOCTL.AFD.BIND

常量

第 2321 行

CTL_CODE

std.os.windows.IOCTL.AFD.CONNECT

常量

第 2322 行

CTL_CODE

std.os.windows.IOCTL.AFD.CONTROL_CODE

容器

第 2315 行

字段

Method: CTL_CODE.METHOD
Function: u10
DeviceType: CTL_CODE.FILE_DEVICE
Reserved28: u4 = 0

std.os.windows.IOCTL.AFD.DEFER_ACCEPT

常量

第 2361 行

CTL_CODE

std.os.windows.IOCTL.AFD.ENUM_NETWORK_EVENTS

常量

第 2359 行

CTL_CODE

std.os.windows.IOCTL.AFD.EVENT_SELECT

常量

第 2358 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_ADDRESS

常量

第 2333 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_CONNECT_DATA

常量

第 2345 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_CONNECT_OPTIONS

常量

第 2346 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_CONTEXT

常量

第 2338 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_CONTEXT_LENGTH

常量

第 2337 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_DISCONNECT_DATA

常量

第 2347 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_DISCONNECT_OPTIONS

常量

第 2348 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_INFORMATION

常量

第 2354 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_QOS

常量

第 2364 行

CTL_CODE

std.os.windows.IOCTL.AFD.GET_UNACCEPTED_CONNECT_DATA

常量

第 2367 行

CTL_CODE

std.os.windows.IOCTL.AFD.NO_OPERATION

常量

第 2365 行

CTL_CODE

std.os.windows.IOCTL.AFD.PARTIAL_DISCONNECT

常量

第 2331 行

CTL_CODE

std.os.windows.IOCTL.AFD.POLL

常量

第 2330 行

CTL_CODE

std.os.windows.IOCTL.AFD.QUERY_HANDLES

常量

第 2335 行

CTL_CODE

std.os.windows.IOCTL.AFD.QUERY_RECEIVE_INFO

常量

第 2334 行

CTL_CODE

std.os.windows.IOCTL.AFD.QUEUE_APC

常量

第 2369 行

CTL_CODE

std.os.windows.IOCTL.AFD.RECEIVE

常量

第 2326 行

CTL_CODE

std.os.windows.IOCTL.AFD.RECEIVE_DATAGRAM

常量

第 2327 行

CTL_CODE

std.os.windows.IOCTL.AFD.RECV_MSG

常量

第 2373 行

CTL_CODE

std.os.windows.IOCTL.AFD.RIO

常量

第 2374 行

CTL_CODE

std.os.windows.IOCTL.AFD.SEND

常量

第 2328 行

CTL_CODE

std.os.windows.IOCTL.AFD.SEND_DATAGRAM

常量

第 2329 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_CONNECT_DATA

常量

第 2341 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_CONNECT_OPTIONS

常量

第 2342 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_CONTEXT

常量

第 2339 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_DISCONNECT_DATA

常量

第 2343 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_DISCONNECT_OPTIONS

常量

第 2344 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_INFORMATION

常量

第 2336 行

CTL_CODE

std.os.windows.IOCTL.AFD.SET_QOS

常量

第 2363 行

CTL_CODE

std.os.windows.IOCTL.AFD.SIZE_CONNECT_DATA

常量

第 2349 行

CTL_CODE

std.os.windows.IOCTL.AFD.SIZE_CONNECT_OPTIONS

常量

第 2350 行

CTL_CODE

std.os.windows.IOCTL.AFD.SIZE_DISCONNECT_DATA

常量

第 2351 行

CTL_CODE

std.os.windows.IOCTL.AFD.SIZE_DISCONNECT_OPTIONS

常量

第 2352 行

CTL_CODE

std.os.windows.IOCTL.AFD.SOCKOPT

常量

第 2371 行

CTL_CODE

std.os.windows.IOCTL.AFD.START_LISTEN

常量

第 2323 行

CTL_CODE

std.os.windows.IOCTL.AFD.SUPER_ACCEPT

常量

第 2356 行

CTL_CODE

std.os.windows.IOCTL.AFD.SUPER_CONNECT

常量

第 2372 行

CTL_CODE

std.os.windows.IOCTL.AFD.TRANSMIT_FILE

常量

第 2355 行

CTL_CODE

std.os.windows.IOCTL.AFD.VALIDATE_GROUP

常量

第 2366 行

CTL_CODE

std.os.windows.IOCTL.AFD.WAIT_FOR_LISTEN

常量

第 2324 行

CTL_CODE

std.os.windows.IOCTL.AFD.WAIT_FOR_LISTEN_LIFO

常量

第 2362 行

CTL_CODE

std.os.windows.IOCTL.CONDRV

命名空间

第 2376 行

std.os.windows.IOCTL.CONDRV.ALLOW_VIA_UIACCESS

常量

第 2388 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.COMPLETE_IO

常量

第 2378 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.DISCONNECT_PIPE

常量

第 2382 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.GET_DISPLAY_SIZE

常量

第 2385 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.GET_FONT_SIZE

常量

第 2390 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.GET_SERVER_PID

常量

第 2384 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.ISSUE_USER_IO

常量

第 2381 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.LAUNCH_SERVER

常量

第 2389 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.READ_INPUT

常量

第 2379 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.READ_IO

常量

第 2377 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.SET_CURSOR

常量

第 2387 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.SET_SERVER_INFORMATION

常量

第 2383 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.UPDATE_DISPLAY

常量

第 2386 行

CTL_CODE

std.os.windows.IOCTL.CONDRV.WRITE_OUTPUT

常量

第 2380 行

CTL_CODE

std.os.windows.IOCTL.KSEC

命名空间

第 2392 行

std.os.windows.IOCTL.KSEC.GEN_RANDOM

常量

第 2393 行

CTL_CODE

std.os.windows.IOCTL.MOUNTMGR

命名空间

第 2395 行

std.os.windows.IOCTL.MOUNTMGR.QUERY_DOS_VOLUME_PATH

常量

第 2397 行

CTL_CODE

std.os.windows.IOCTL.MOUNTMGR.QUERY_POINTS

常量

第 2396 行

CTL_CODE

std.os.windows.IsProcessorFeaturePresent

函数

第 5994 行

pub fn IsProcessorFeaturePresent(feature: PF) bool

参数

feature: PF

std.os.windows.KAFFINITY

类型

第 5027 行

std.os.windows.KERNEL_USER_TIMES

容器

第 6000 行

字段

CreationTime: LARGE_INTEGER
ExitTime: LARGE_INTEGER
KernelTime: LARGE_INTEGER
UserTime: LARGE_INTEGER

std.os.windows.kernel32

别名

第 18 行

别名目标 std.os.windows.kernel32

std.os.windows.KEY

命名空间

第 4485 行

std.os.windows.KEY.VALUE

命名空间

第 4486 行

std.os.windows.KEY.VALUE.INFORMATION_CLASS

容器

第 4488 行

字段

Basic = 0
Full = 1
Partial = 2
FullAlign64 = 3
PartialAlign64 = 4
Layer = 5
_

std.os.windows.KEY.VALUE.INFORMATION_CLASS.Max

常量

第 4497 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.KEY.VALUE.PARTIAL_INFORMATION

容器

第 4500 行

字段

TitleIndex: ULONG
Type: REG.ValueType
DataLength: ULONG
Data: [0]UCHAR

std.os.windows.KEY.VALUE.PARTIAL_INFORMATION.data

函数

第 4506 行

pub fn data(info: *const PARTIAL_INFORMATION) []const UCHAR

参数

info: *const PARTIAL_INFORMATION

std.os.windows.KNONVOLATILE_CONTEXT_POINTERS

类型

第 4937 行

std.os.windows.KPRIORITY

类型

第 5028 行

std.os.windows.KSYSTEM_TIME

容器

第 5831 行

字段

LowPart: ULONG
High1Time: LONG
High2Time: LONG

std.os.windows.KUSER_SHARED_DATA

容器

第 5862 行

共享内核用户数据

字段

TickCountLowDeprecated: ULONG
TickCountMultiplier: ULONG
InterruptTime: KSYSTEM_TIME
SystemTime: KSYSTEM_TIME
TimeZoneBias: KSYSTEM_TIME
ImageNumberLow: USHORT
ImageNumberHigh: USHORT
NtSystemRoot: [260]WCHAR
MaxStackTraceDepth: ULONG
CryptoExponent: ULONG
TimeZoneId: ULONG
LargePageMinimum: ULONG
AitSamplingValue: ULONG
AppCompatFlag: ULONG
RNGSeedVersion: ULONGLONG
GlobalValidationRunlevel: ULONG
TimeZoneBiasStamp: LONG
NtBuildNumber: ULONG
NtProductType: NT_PRODUCT_TYPE
ProductTypeIsValid: BOOLEAN
Reserved0: [1]BOOLEAN
NativeProcessorArchitecture: USHORT
NtMajorVersion: ULONG
NtMinorVersion: ULONG
ProcessorFeatures: [PROCESSOR_FEATURE_MAX]BOOLEAN
Reserved1: ULONG
Reserved3: ULONG
TimeSlip: ULONG
AlternativeArchitecture: ALTERNATIVE_ARCHITECTURE_TYPE
BootId: ULONG
SystemExpirationDate: LARGE_INTEGER
SuiteMaskY: ULONG
KdDebuggerEnabled: BOOLEAN
DummyUnion1: extern union {
    MitigationPolicies: UCHAR,
    Alt: packed struct(u8) {
        NXSupportPolicy: u2,
        SEHValidationPolicy: u2,
        CurDirDevicesSkippedForDlls: u2,
        Reserved: u2,
    },
}
CyclesPerYield: USHORT
ActiveConsoleId: ULONG
DismountCount: ULONG
ComPlusPackage: ULONG
LastSystemRITEventTickCount: ULONG
NumberOfPhysicalPages: ULONG
SafeBootMode: BOOLEAN
DummyUnion2: extern union {
    VirtualizationFlags: UCHAR,
    Alt: packed struct(u8) {
        ArchStartedInEl2: u1,
        QcSlIsSupported: u1,
        SpareBits: u6,
    },
}
Reserved12: [2]UCHAR
DummyUnion3: extern union {
    SharedDataFlags: ULONG,
    Alt: packed struct(u32) {
        DbgErrorPortPresent: u1,
        DbgElevationEnabled: u1,
        DbgVirtEnabled: u1,
        DbgInstallerDetectEnabled: u1,
        DbgLkgEnabled: u1,
        DbgDynProcessorEnabled: u1,
        DbgConsoleBrokerEnabled: u1,
        DbgSecureBootEnabled: u1,
        DbgMultiSessionSku: u1,
        DbgMultiUsersInSessionSku: u1,
        DbgStateSeparationEnabled: u1,
        SpareBits: u21,
    },
}
DataFlagsPad: [1]ULONG
TestRetInstruction: ULONGLONG
QpcFrequency: LONGLONG
SystemCall: ULONG
Reserved2: ULONG
SystemCallPad: [2]ULONGLONG
DummyUnion4: extern union {
    TickCount: KSYSTEM_TIME,
    TickCountQuad: ULONG64,
    Alt: extern struct {
        ReservedTickCountOverlay: [3]ULONG,
        TickCountPad: [1]ULONG,
    },
}
Cookie: ULONG
CookiePad: [1]ULONG
ConsoleSessionForegroundProcessId: LONGLONG
TimeUpdateLock: ULONGLONG
BaselineSystemTimeQpc: ULONGLONG
BaselineInterruptTimeQpc: ULONGLONG
QpcSystemTimeIncrement: ULONGLONG
QpcInterruptTimeIncrement: ULONGLONG
QpcSystemTimeIncrementShift: UCHAR
QpcInterruptTimeIncrementShift: UCHAR
UnparkedProcessorCount: USHORT
EnclaveFeatureMask: [4]ULONG
TelemetryCoverageRound: ULONG
UserModeGlobalLogger: [16]USHORT
ImageFileExecutionOptions: ULONG
LangGenerationCount: ULONG
Reserved4: ULONGLONG
InterruptTimeBias: ULONGLONG
QpcBias: ULONGLONG
ActiveProcessorCount: ULONG
ActiveGroupCount: UCHAR
Reserved9: UCHAR
DummyUnion5: extern union {
    QpcData: USHORT,
    Alt: extern struct {
        QpcBypassEnabled: UCHAR,
        QpcShift: UCHAR,
    },
}
TimeZoneBiasEffectiveStart: LARGE_INTEGER
TimeZoneBiasEffectiveEnd: LARGE_INTEGER
XState: XSTATE_CONFIGURATION
FeatureConfigurationChangeStamp: KSYSTEM_TIME
Spare: ULONG
UserPointerAuthMask: ULONG64

std.os.windows.LANG

别名

第 4022 行

别名目标 std.os.windows.lang

std.os.windows.LANGID

类型

第 4075 行

std.os.windows.LARGE_INTEGER

类型

第 4066 行

std.os.windows.LDR

命名空间

第 5297 行

std.os.windows.LDR.DATA_TABLE_ENTRY

容器

第 5301 行

字段

InLoadOrderLinks: LIST_ENTRY
InMemoryOrderLinks: LIST_ENTRY
InInitializationOrderLinks: LIST_ENTRY
DllBase: PVOID
EntryPoint: PVOID
SizeOfImage: ULONG
FullDllName: UNICODE_STRING
BaseDllName: UNICODE_STRING
Reserved5: [3]PVOID
DUMMYUNIONNAME: extern union {
    CheckSum: ULONG,
    Reserved6: PVOID,
}
TimeDateStamp: ULONG

std.os.windows.LDR.DLL_NOTIFICATION

命名空间

第 5318 行

std.os.windows.LDR.DLL_NOTIFICATION.COOKIE

类型

第 5342 行

std.os.windows.LDR.DLL_NOTIFICATION.DATA

容器

第 5321 行

字段

Loaded: LOADED
Unloaded: UNLOADED

std.os.windows.LDR.DLL_NOTIFICATION.DATA.LOADED

容器

第 5325 行

字段

Flags: REGISTER
FullDllName: *const UNICODE_STRING
BaseDllName: *const UNICODE_STRING
DllBase: PVOID
SizeOfImage: ULONG

std.os.windows.LDR.DLL_NOTIFICATION.DATA.UNLOADED

容器

第 5333 行

字段

Flags: REGISTER
FullDllName: *const UNICODE_STRING
BaseDllName: *const UNICODE_STRING
DllBase: PVOID
SizeOfImage: ULONG

std.os.windows.LDR.DLL_NOTIFICATION.FUNCTION

常量

第 5344 行

std.os.windows.LDR.DLL_NOTIFICATION.REASON

容器

第 5319 行

字段

LOADED = 1
UNLOADED = 2

std.os.windows.LDR.DLL_NOTIFICATION.REGISTER

容器

第 5350 行

字段

Reserved0: u32 = 0

std.os.windows.LDR.GET_DLL_HANDLE_EX

容器

第 5355 行

字段

UNCHANGED_REFCOUNT: bool = false
PIN: bool = false
Reserved2: u30 = 0

std.os.windows.LDR.GET_PROCEDURE_ADDRESS

容器

第 5361 行

字段

DONT_RECORD_FORWARDER: bool = false
Reserved1: u31 = 0

std.os.windows.LDR.LOAD

容器

第 5366 行

字段

DONT_RESOLVE_DLL_REFERENCES: bool = false
LIBRARY_AS_DATAFILE: bool = false
PACKAGED_LIBRARY: bool = false
WITH_ALTERED_SEARCH_PATH: bool = false
IGNORE_CODE_AUTHZ_LEVEL: bool = false
LIBRARY_AS_IMAGE_RESOURCE: bool = false
LIBRARY_AS_DATAFILE_EXCLUSIVE: bool = false
LIBRARY_REQUERE_SIGNED_TARGET: bool = false
LIBRARY_SEARCH_DLL_LOAD_DIR: bool = false
LIBRARY_SEARCH_USER_DIRS: bool = false
LIBRARY_SEARCH_SYSTEM32: bool = false
LIBRARY_SEARCH_DEFAULT_DIRS: bool = false

std.os.windows.LIST_ENTRY

容器

第 4526 行

字段

Flink: *LIST_ENTRY
Blink: *LIST_ENTRY

std.os.windows.LOGICAL

别名

第 3570 行

别名目标 std.os.windows.ULONG

std.os.windows.LONG

类型

第 4071 行

std.os.windows.LONG_PTR

类型

第 4060 行

std.os.windows.LONGLONG

类型

第 4074 行

std.os.windows.LPARAM

别名

第 4078 行

别名目标 std.os.windows.LONG_PTR

std.os.windows.LPCSTR

类型

第 4046 行

std.os.windows.LPCTSTR

常量

第 4084 行

std.os.windows.LPCVOID

类型

第 4047 行

std.os.windows.LPCWSTR

类型

第 4051 行

std.os.windows.LPSTR

类型

第 4048 行

std.os.windows.LPTSTR

常量

第 4083 行

std.os.windows.LPVOID

类型

第 4049 行

std.os.windows.LPWSTR

类型

第 4050 行

std.os.windows.LSTATUS

别名

第 4313 行

别名目标 std.os.windows.LONG

std.os.windows.M128A

类型

第 4617 行

std.os.windows.MAKELANGID

函数

第 3973 行

inline fn MAKELANGID(p: c_ushort, s: c_ushort) LANGID

参数

p: c_ushort
s: c_ushort

std.os.windows.math

别名

第 14 行

别名目标 std.math

std.os.windows.MAX_PATH

常量

第 4166 行

std.os.windows.MAX_WOW64_SHARED_ENTRIES

常量

第 5827 行

std.os.windows.MAXIMUM_REPARSE_DATA_BUFFER_SIZE

常量

第 2401 行

ULONG

std.os.windows.MAXIMUM_XSTATE_FEATURES

常量

第 5829 行

std.os.windows.maxInt

别名

第 15 行

别名目标 std.math.maxInt

std.os.windows.mem

别名

第 12 行

别名目标 std.mem

std.os.windows.MEM

命名空间

第 3418 行

std.os.windows.MEM.ALLOCATE

容器

第 3419 行

字段

Reserved0: u12 = 0
COMMIT: bool = false
RESERVE: bool = false
REPLACE_PLACEHOLDER: bool = false
Reserved15: u3 = 0
RESERVE_PLACEHOLDER: bool = false
RESET: bool = false
TOP_DOWN: bool = false
WRITE_WATCH: bool = false
PHYSICAL: bool = false
Reserved23: u1 = 0
RESET_UNDO: bool = false
Reserved25: u4 = 0
LARGE_PAGES: bool = false
Reserved30: u1 = 0
@"4MB_PAGES": bool = false

std.os.windows.MEM.ALLOCATE.@"64K_PAGES"

常量

第 3437 行

ALLOCATE

std.os.windows.MEM.EXTENDED_PARAMETER

容器

第 3468 行

字段

s: packed struct(ULONG64) {
    Type: TYPE,
    Reserved: u56,
}
u: extern union {
    ULong64: ULONG64,
    Pointer: PVOID,
    Size: SIZE_T,
    Handle: HANDLE,
    ULong: ULONG,
}

std.os.windows.MEM.EXTENDED_PARAMETER.TYPE

容器

第 3481 行

字段

InvalidType = 0
AddressRequirements
NumaNode
PartitionHandle
UserPhysicalHandle
AttributeFlags
ImageMachine
_

std.os.windows.MEM.EXTENDED_PARAMETER.TYPE.Max

常量

第 3491 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.MEM.FREE

容器

第 3443 行

字段

COALESCE_PLACEHOLDERS: bool = false
PRESERVE_PLACEHOLDER: bool = false
Reserved2: u12 = 0
DECOMMIT: bool = false
RELEASE: bool = false
FREE: bool = false
Reserved17: u15 = 0

std.os.windows.MEM.MAP

容器

第 3453 行

字段

Reserved0: u13 = 0
RESERVE: bool = false
REPLACE_PLACEHOLDER: bool = false
Reserved15: u14 = 0
LARGE_PAGES: bool = false
Reserved30: u2 = 0

std.os.windows.MEM.UNMAP

容器

第 3462 行

字段

WITH_TRANSIENT_BOOST: bool = false
PRESERVE_PLACEHOLDER: bool = false
Reserved2: u30 = 0

std.os.windows.MEMORY_RANGE_ENTRY

容器

第 3548 行

字段

VirtualAddress: PVOID
NumberOfBytes: SIZE_T

std.os.windows.MODULEINFO

容器

第 5487 行

字段

lpBaseOfDll: LPVOID
SizeOfImage: DWORD
EntryPoint: LPVOID

std.os.windows.MOUNT_POINT_REPARSE_BUFFER

容器

第 5517 行

字段

SubstituteNameOffset: USHORT
SubstituteNameLength: USHORT
PrintNameOffset: USHORT
PrintNameLength: USHORT
PathBuffer: [1]WCHAR

std.os.windows.MOUNTMGR_MOUNT_POINT

容器

第 5529 行

字段

SymbolicLinkNameOffset: ULONG
SymbolicLinkNameLength: USHORT
Reserved1: USHORT
UniqueIdOffset: ULONG
UniqueIdLength: USHORT
Reserved2: USHORT
DeviceNameOffset: ULONG
DeviceNameLength: USHORT
Reserved3: USHORT

std.os.windows.MOUNTMGR_MOUNT_POINTS

容器

第 5540 行

字段

Size: ULONG
NumberOfMountPoints: ULONG
MountPoints: [1]MOUNTMGR_MOUNT_POINT

std.os.windows.MOUNTMGR_TARGET_NAME

容器

第 5546 行

字段

DeviceNameLength: USHORT
DeviceName: [1]WCHAR

std.os.windows.MOUNTMGR_VOLUME_PATHS

容器

第 5550 行

字段

MultiSzLength: ULONG
MultiSz: [1]WCHAR

std.os.windows.NAME_MAX

常量

第 4585 行

[每个文件名组成部分的长度]最多可达 GetVolumeInformation 函数的 lpMaximumComponentLength 参数所返回的值 (此值通常为 255 个字符) 来源:https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation

存储在变量中的值(lpMaximumComponentLength 指向该变量)用于指示指定文件系统是否支持长文件名。例如,对于支持长文件名的 FAT 文件系统,该函数存储值 255,而不是先前的 8.3 指示值。使用 NTFS 文件系统的系统同样可以支持长文件名。 来源:https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-getvolumeinformationw

这里假设 lpMaximumComponentLength 虽然可能变化,但永远不会大于 255。

TODO: 进一步验证此假设。

std.os.windows.native_arch

常量

第 8 行

std.os.windows.NEON128

类型

第 4647 行

std.os.windows.NET

命名空间

第 1495 行

std.os.windows.NET.IFINDEX

容器

第 1497 行

字段

_

std.os.windows.NET.LUID

容器

第 1496 行

字段

Reserved: u24 = 0
Index: u24
IfType: u16

std.os.windows.nls

别名

第 22 行

别名目标 std.os.windows.nls

std.os.windows.normalizePath

函数

第 3888 行

通过以下步骤规范化 Windows 路径:

  1. 将所有正斜杠转换为反斜杠
  2. 合并重复的反斜杠
  3. 移除“.”和“..”目录部分 返回新路径的长度。
pub fn normalizePath(comptime T: type, path: []T) RemoveDotDirsError!usize

参数

T: type
path: []T

错误

TooManyParentDirs

std.os.windows.NT_PRODUCT_TYPE

容器

第 5837 行

字段

NtProductWinNt = 1
NtProductLanManNt
NtProductServer

std.os.windows.NT_TIB

容器

第 5084 行

字段

ExceptionList: ?*EXCEPTION_REGISTRATION_RECORD
StackBase: PVOID
StackLimit: PVOID
SubSystemTib: PVOID
DUMMYUNIONNAME: extern union { FiberData: PVOID, Version: DWORD }
ArbitraryUserPointer: PVOID
Self: ?*@This()

std.os.windows.ntdll

别名

第 19 行

别名目标 std.os.windows.ntdll

std.os.windows.NTSTATUS

别名

第 3572 行

别名目标 std.os.windows.ntstatus.NTSTATUS

std.os.windows.ntToWin32Namespace

函数

第 3937 行

类似于 RtlNtPathNameToDosPathName,但不进行任何堆分配。 可能的转换如下: ??\C:\Some\Path -> C:\Some\Path ??\UNC\server\share\foo -> \server\share\foo 若路径不含 NT 命名空间前缀,则返回 error.NotNtPath。

功能基于以下 ReactOS 测试用例: https://github.com/reactos/reactos/blob/master/modules/rostests/apitests/ntdll/RtlNtPathNameToDosPathName.c

path 应采用 WTF-16LE 编码。

支持原地修改,path 和 out 可以引用同一切片。

pub fn ntToWin32Namespace(path: []const u16, out: []u16) error{ NameTooLong, NotNtPath }![]u16

参数

path: []const u16
out: []u16

错误

NameTooLong
NotNtPath

用法示例

test ntToWin32Namespace {
    const L = std.unicode.utf8ToUtf16LeStringLiteral;

    var mutable_unc_path_buf = L("\\??\\UNC\\path1\\path2").*;
    try std.testing.expectEqualSlices(u16, L("\\\\path1\\path2"), try ntToWin32Namespace(&mutable_unc_path_buf, &mutable_unc_path_buf));

    var mutable_path_buf = L("\\??\\C:\\test\\").*;
    try std.testing.expectEqualSlices(u16, L("C:\\test\\"), try ntToWin32Namespace(&mutable_path_buf, &mutable_path_buf));

    var too_small_buf: [6]u16 = undefined;
    try std.testing.expectError(error.NameTooLong, ntToWin32Namespace(L("\\??\\C:\\test"), &too_small_buf));
}

std.os.windows.OBJECT

命名空间

第 95 行

std.os.windows.OBJECT.ATTRIBUTES

容器

第 98 行

字段

Length: ULONG = @sizeOf(ATTRIBUTES)
RootDirectory: ?HANDLE = null
ObjectName: ?*UNICODE_STRING = @constCast(&UNICODE_STRING.empty)
Attributes: Flags = .{}
SecurityDescriptor: ?*anyopaque = null
SecurityQualityOfService: ?*anyopaque = null

std.os.windows.OBJECT.ATTRIBUTES.Flags

容器

第 107 行

字段

Reserved0: u1 = 0
INHERIT: bool = false
Reserved2: u2 = 0
PERMANENT: bool = false
EXCLUSIVE: bool = false
CASE_INSENSITIVE: bool = true

名称查找代码是否应忽略 ObjectName 成员的大小写,而非执行精确匹配搜索。

OPENIF: bool = false
OPENLINK: bool = false
KERNEL_HANDLE: bool = false
FORCE_ACCESS_CHECK: bool = false
IGNORE_IMPERSONATED_DEVICEMAP: bool = false
DONT_REPARSE: bool = false
Reserved13: u19 = 0

std.os.windows.OBJECT.ATTRIBUTES.Flags.VALID_ATTRIBUTES

常量

第 123 行

ATTRIBUTES

std.os.windows.OBJECT.BASIC_INFORMATION

容器

第 150 行

字段

Attributes: ATTRIBUTES.Flags
GrantedAccess: ACCESS_MASK
HandleCount: ULONG
PointerCount: ULONG
Reserved: [10]ULONG

std.os.windows.OBJECT.HANDLE_FLAG

容器

第 162 行

字段

INHERIT: bool = false
PROTECT_FROM_CLOSE: bool = false
Reserved1: u14 = 0

std.os.windows.OBJECT.INFORMATION_CLASS

容器

第 138 行

字段

Basic = 0
Name = 1
Type = 2
Types = 3
HandleFlag = 4
Session = 5
_

std.os.windows.OBJECT.INFORMATION_CLASS.Max

常量

第 147 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.OBJECT.NAME_INFORMATION

容器

第 158 行

字段

std.os.windows.OSVERSIONINFOW

容器

第 5493 行

字段

dwOSVersionInfoSize: ULONG
dwMajorVersion: ULONG
dwMinorVersion: ULONG
dwBuildNumber: ULONG
dwPlatformId: ULONG
szCSDVersion: [128]WCHAR

std.os.windows.PAGE

容器

第 3375 行

字段

NOACCESS: bool = false
READONLY: bool = false
READWRITE: bool = false
WRITECOPY: bool = false
EXECUTE: bool = false
EXECUTE_READ: bool = false
EXECUTE_READWRITE: bool = false
EXECUTE_WRITECOPY: bool = false
GUARD: bool = false
NOCACHE: bool = false
WRITECOMBINE: bool = false
GRAPHICS_NOACCESS: bool = false
GRAPHICS_READONLY: bool = false
GRAPHICS_READWRITE: bool = false
GRAPHICS_EXECUTE: bool = false
GRAPHICS_EXECUTE_READ: bool = false
GRAPHICS_EXECUTE_READWRITE: bool = false
GRAPHICS_COHERENT: bool = false
GRAPHICS_NOCACHE: bool = false
Reserved19: u12 = 0
REVERT_TO_FILE_MAP: bool = false

std.os.windows.PAGE.fromProtection

函数

第 3403 行

pub fn fromProtection(protection: std.process.MemoryProtection) ?PAGE

参数

std.os.windows.PATH_MAX_WIDE

常量

第 4567 行

路径最大长度 32,767 字符只是近似值,因为“\?\” 前缀可能在运行时被系统扩展成更长的字符串, 且扩展后的长度计入总长度。 来自 https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file#maximum-path-length-limitation

std.os.windows.PCTSTR

常量

第 4086 行

std.os.windows.PCWSTR

类型

第 4054 行

std.os.windows.peb

函数

第 3694 行

pub fn peb() *PEB

std.os.windows.PEB

容器

第 5098 行

字段

InheritedAddressSpace: BOOLEAN
ReadImageFileExecOptions: BOOLEAN
BeingDebugged: BOOLEAN
BitField: UCHAR
Mutant: HANDLE
ImageBaseAddress: HMODULE
Ldr: *PEB_LDR_DATA
ProcessParameters: *RTL_USER_PROCESS_PARAMETERS
SubSystemData: PVOID
ProcessHeap: ?*HEAP
FastPebLock: *RTL_CRITICAL_SECTION
AtlThunkSListPtr: PVOID
IFEOKey: PVOID
CrossProcessFlags: ULONG
union1: extern union {
    KernelCallbackTable: PVOID,
    UserSharedInfoPtr: PVOID,
}
SystemReserved: ULONG
AtlThunkSListPtr32: ULONG
ApiSetMap: PVOID
TlsExpansionCounter: ULONG
TlsBitmap: *RTL_BITMAP
TlsBitmapBits: [2]ULONG
ReadOnlySharedMemoryBase: PVOID

与 CSR 服务器共享的内存区域在本方的基址。

SharedData: PVOID
ReadOnlyStaticServerData: *UnknownStaticServerDataIndirection
AnsiCodePageData: PVOID
OemCodePageData: PVOID
UnicodeCaseTableData: PVOID
NumberOfProcessors: ULONG
NtGlobalFlag: ULONG
CriticalSectionTimeout: LARGE_INTEGER
HeapSegmentReserve: ULONG_PTR
HeapSegmentCommit: ULONG_PTR
HeapDeCommitTotalFreeThreshold: ULONG_PTR
HeapDeCommitFreeBlockThreshold: ULONG_PTR
NumberOfHeaps: ULONG
MaximumNumberOfHeaps: ULONG
ProcessHeaps: *PVOID
GdiSharedHandleTable: PVOID
ProcessStarterHelper: PVOID
GdiDCAttributeList: ULONG
LoaderLock: *RTL_CRITICAL_SECTION
OSMajorVersion: ULONG
OSMinorVersion: ULONG
OSBuildNumber: USHORT
OSCSDVersion: USHORT
OSPlatformId: ULONG
ImageSubSystem: ULONG
ImageSubSystemMajorVersion: ULONG
ImageSubSystemMinorVersion: ULONG
ActiveProcessAffinityMask: KAFFINITY
GdiHandleBuffer: [
    switch (@sizeOf(usize)) {
        4 => 0x22,
        8 => 0x3C,
        else => unreachable,
    }
]ULONG
PostProcessInitRoutine: PVOID
TlsExpansionBitmap: *RTL_BITMAP
TlsExpansionBitmapBits: [32]ULONG
SessionId: ULONG
AppCompatFlags: ULARGE_INTEGER
AppCompatFlagsUser: ULARGE_INTEGER
ShimData: PVOID
AppCompatInfo: PVOID
CSDVersion: UNICODE_STRING
ActivationContextData: *const ACTIVATION_CONTEXT_DATA
ProcessAssemblyStorageMap: *ASSEMBLY_STORAGE_MAP
SystemDefaultActivationData: *const ACTIVATION_CONTEXT_DATA
SystemAssemblyStorageMap: *ASSEMBLY_STORAGE_MAP
MinimumStackCommit: ULONG_PTR
FlsCallback: *FLS_CALLBACK_INFO
FlsListHead: LIST_ENTRY
FlsBitmap: *RTL_BITMAP
FlsBitmapBits: [4]ULONG
FlsHighIndex: ULONG
WerRegistrationData: PVOID
WerShipAssertPtr: PVOID
pUnused: PVOID
pImageHeaderHash: PVOID
TracingFlags: ULONG
CsrServerReadOnlySharedMemoryBase: ULONGLONG

与 CSR 服务器共享的内存区域在 CSRSS 地址空间中的基址。

TppWorkerpListLock: ULONG
TppWorkerpList: LIST_ENTRY
WaitOnAddressHashTable: [0x80]PVOID
TelemetryCoverageHeader: PVOID
CloudFileFlags: ULONG

std.os.windows.PEB_LDR_DATA

容器

第 5269 行

PEB_LDR_DATA 结构体是进程已加载模块的主要记录。 它本质上是三个双链表的表头,链表元素为 LDR.DATA_TABLE_ENTRY 结构体,每个表示一个已加载模块。

微软对此的文档不完整,这里的字段取自多种资料,包括:

字段

Length: ULONG

结构体的字节大小

Initialized: BOOLEAN

若结构已准备好,则为 TRUE。

SsHandle: PVOID
InLoadOrderModuleList: LIST_ENTRY
InMemoryOrderModuleList: LIST_ENTRY
InInitializationOrderModuleList: LIST_ENTRY
EntryInProgress: PVOID

尚不清楚此字段在 Windows 8 及以上版本中的用途。

ShutdownInProgress: BOOLEAN
ShutdownThreadId: HANDLE

虽然 ShutdownThreadId 声明为 HANDLE, 但顾名思义,它实际上是线程标识符。 它来自请求终止进程的线程的 TEB 内 CLIENT_ID 的 UniqueThread 成员。

std.os.windows.PEB.UnknownStaticServerDataIndirection

容器

第 5257 行

此结构体的具体细节未知,但实验和对 kernelbase.dll 的逆向分析 确认偏移 8 处存在一个字段。

字段

unknown: u64
base_static_server_data_addr: u64

位于 CSRSS 地址空间。

std.os.windows.peb.zig_windows_peb

函数

第 3698 行

这是 C 后端的临时规避措施,直到 zig 能够将 C 代码放入内联汇编。

extern fn zig_windows_peb() callconv(.c) *anyopaque

std.os.windows.PF

容器

第 5566 行

处理器特性枚举。

字段

FLOATING_POINT_PRECISION_ERRATA = 0

在 Pentium 上,极少数情况下会发生浮点精度错误。

FLOATING_POINT_EMULATED = 1

使用软件模拟器模拟浮点运算。 若浮点运算被模拟,则此函数返回非零值;否则返回零。

COMPARE_EXCHANGE_DOUBLE = 2

支持原子比较并交换操作(cmpxchg)。

MMX_INSTRUCTIONS_AVAILABLE = 3

MMX 指令集可用。

PPC_MOVEMEM_64BIT_OK = 4
ALPHA_BYTE_INSTRUCTIONS = 5
XMMI_INSTRUCTIONS_AVAILABLE = 6

可使用 SSE 指令集。

@"3DNOW_INSTRUCTIONS_AVAILABLE" = 7

3D-Now 指令可用。

RDTSC_INSTRUCTION_AVAILABLE = 8

RDTSC 指令可用。

PAE_ENABLED = 9

处理器已启用 PAE。

XMMI64_INSTRUCTIONS_AVAILABLE = 10

SSE2 指令集可用。

SSE_DAZ_MODE_AVAILABLE = 11
NX_ENABLED = 12

已启用数据执行保护。

SSE3_INSTRUCTIONS_AVAILABLE = 13

可使用 SSE3 指令集。

COMPARE_EXCHANGE128 = 14

支持原子 128 位比较并交换操作(cmpxchg16b)。

COMPARE64_EXCHANGE128 = 15

支持原子的比较 64 位并交换 128 位操作(cmp8xchg16)。

CHANNELS_ENABLED = 16

已启用处理器通道。

XSAVE_ENABLED = 17

处理器实现 XSAVI 和 XRSTOR 指令。

ARM_VFP_32_REGISTERS_AVAILABLE = 18

存在 VFP/Neon:32 x 64 位寄存器组。 此标志与 PF_ARM_VFP_EXTENDED_REGISTERS 含义相同。

ARM_NEON_INSTRUCTIONS_AVAILABLE = 19

此 ARM 处理器实现 ARM v8 NEON 指令集。

SECOND_LEVEL_ADDRESS_TRANSLATION = 20

硬件支持第二级地址转换。

VIRT_FIRMWARE_ENABLED = 21

固件中已启用虚拟化,且操作系统已提供该功能。

RDWRFSGBASE_AVAILABLE = 22

RDFSBASE、RDGSBASE、WRFSBASE 和 WRGSBASE 指令可用。

FASTFAIL_AVAILABLE = 23

_fastfail() 可用。

ARM_DIVIDE_INSTRUCTION_AVAILABLE = 24

除法指令可用。

ARM_64BIT_LOADSTORE_ATOMIC = 25

支持 64 位加载及存储原子指令。

ARM_EXTERNAL_CACHE_AVAILABLE = 26

外部缓存可用。

ARM_FMAC_INSTRUCTIONS_AVAILABLE = 27

支持浮点乘加指令。

RDRAND_INSTRUCTION_AVAILABLE = 28
ARM_V8_INSTRUCTIONS_AVAILABLE = 29

此 ARM 处理器实现 ARM v8 指令集。

ARM_V8_CRYPTO_INSTRUCTIONS_AVAILABLE = 30

此 ARM 处理器实现 ARM v8 额外密码学指令,即 AES、SHA1 和 SHA2。

ARM_V8_CRC32_INSTRUCTIONS_AVAILABLE = 31

此 ARM 处理器实现 ARM v8 额外的 CRC32 指令。

RDTSCP_INSTRUCTION_AVAILABLE = 32
RDPID_INSTRUCTION_AVAILABLE = 33
ARM_V81_ATOMIC_INSTRUCTIONS_AVAILABLE = 34

此 ARM 处理器实现 ARM v8.1 原子指令(例如 CAS、SWP)。

MONITORX_INSTRUCTION_AVAILABLE = 35
SSSE3_INSTRUCTIONS_AVAILABLE = 36

SSSE3 指令集可用。

SSE4_1_INSTRUCTIONS_AVAILABLE = 37

SSE4_1 指令集可用。

SSE4_2_INSTRUCTIONS_AVAILABLE = 38

可使用 SSE4_2 指令集。

AVX_INSTRUCTIONS_AVAILABLE = 39

AVX 指令集可用。

AVX2_INSTRUCTIONS_AVAILABLE = 40

AVX2 指令集可用。

AVX512F_INSTRUCTIONS_AVAILABLE = 41

AVX512F 指令集可用。

ERMS_AVAILABLE = 42
ARM_V82_DP_INSTRUCTIONS_AVAILABLE = 43

此 ARM 处理器实现 ARM v8.2 点积(DP)指令。

ARM_V83_JSCVT_INSTRUCTIONS_AVAILABLE = 44

此 ARM 处理器实现 ARM v8.3 JavaScript 转换(JSCVT)指令。

ARM_V83_LRCPC_INSTRUCTIONS_AVAILABLE = 45

此 Arm 处理器实现 Arm v8.3 LRCPC 指令,例如 LDAPR。注意,某些 Arm v8.2 CPU 也可能选择性支持 LRCPC 指令。

ARM_SVE_INSTRUCTIONS_AVAILABLE = 46

此 Arm 处理器实现 SVE(可伸缩向量扩展)指令(FEAT_SVE)。

ARM_SVE2_INSTRUCTIONS_AVAILABLE = 47

此 Arm 处理器实现 SVE2 指令(FEAT_SVE2)。

ARM_SVE2_1_INSTRUCTIONS_AVAILABLE = 48

此 Arm 处理器实现 SVE2.1 指令(FEAT_SVE2p1)。

ARM_SVE_AES_INSTRUCTIONS_AVAILABLE = 49

此 Arm 处理器实现 SVE AES 指令(FEAT_SVE_AES)。

ARM_SVE_PMULL128_INSTRUCTIONS_AVAILABLE = 50

此 Arm 处理器实现 SVE 128 位多项式长乘法指令(FEAT_SVE_PMULL128)。

ARM_SVE_BITPERM_INSTRUCTIONS_AVAILABLE = 51

此 Arm 处理器实现 SVE 位排列指令(FEAT_SVE_BitPerm)。

ARM_SVE_BF16_INSTRUCTIONS_AVAILABLE = 52

此 Arm 处理器实现 SVE BF16(BFloat16)指令(FEAT_BF16)。

ARM_SVE_EBF16_INSTRUCTIONS_AVAILABLE = 53

此 Arm 处理器实现 SVE EBF16(扩展 BFloat16)指令(FEAT_EBF16)。

ARM_SVE_B16B16_INSTRUCTIONS_AVAILABLE = 54

此 Arm 处理器实现 SVE B16B16 指令(FEAT_SVE_B16B16)。

ARM_SVE_SHA3_INSTRUCTIONS_AVAILABLE = 55

此 Arm 处理器实现 SVE SHA-3 密码学指令(FEAT_SVE_SHA3)。

ARM_SVE_SM4_INSTRUCTIONS_AVAILABLE = 56

此 Arm 处理器实现 SVE SM4 加密指令(FEAT_SVE_SM4)。

ARM_SVE_I8MM_INSTRUCTIONS_AVAILABLE = 57

此 Arm 处理器实现 SVE I8MM(Int8 矩阵乘法)指令(FEAT_I8MM)。

ARM_SVE_F32MM_INSTRUCTIONS_AVAILABLE = 58

此 Arm 处理器实现 SVE F32MM(FP32 矩阵乘法)指令(FEAT_F32MM)。

ARM_SVE_F64MM_INSTRUCTIONS_AVAILABLE = 59

此 Arm 处理器实现 SVE F64MM(FP64 矩阵乘法)指令(FEAT_F64MM)。

BMI2_INSTRUCTIONS_AVAILABLE = 60

此 x64 处理器实现 BMI2 指令集。

MOVDIR64B_INSTRUCTION_AVAILABLE = 61

此 x64 处理器实现 MOVDIR64B 指令。

ARM_LSE2_AVAILABLE = 62

此 Arm 处理器实现 LSE2 原子指令(FEAT_LSE2)。

ARM_SHA3_INSTRUCTIONS_AVAILABLE = 64

此 Arm 处理器实现 SHA-3 密码指令(FEAT_SHA3)。

ARM_SHA512_INSTRUCTIONS_AVAILABLE = 65

此 Arm 处理器实现 SHA-512 密码学指令(FEAT_SHA512)。

ARM_V82_I8MM_INSTRUCTIONS_AVAILABLE = 66

此 Arm 处理器实现 I8MM(Int8 矩阵乘法)NEON 指令(FEAT_I8MM)。

ARM_V82_FP16_INSTRUCTIONS_AVAILABLE = 67

此 Arm 处理器实现 FP16(半精度浮点)NEON 指令(FEAT_FP16)。

ARM_V86_BF16_INSTRUCTIONS_AVAILABLE = 68

此 Arm 处理器实现 BF16(BFloat16)NEON 指令(FEAT_BF16)。

ARM_V86_EBF16_INSTRUCTIONS_AVAILABLE = 69

此 Arm 处理器实现 EBF16(扩展 BFloat16)NEON 指令(FEAT_EBF16)。

ARM_SME_INSTRUCTIONS_AVAILABLE = 70

此 Arm 处理器实现 SME(可扩展矩阵扩展)指令(FEAT_SME)。

ARM_SME2_INSTRUCTIONS_AVAILABLE = 71

此 Arm 处理器实现 SME2 指令(FEAT_SME2)。

ARM_SME2_1_INSTRUCTIONS_AVAILABLE = 72

此 Arm 处理器实现 SME2.1 指令(FEAT_SME2p1)。

ARM_SME2_2_INSTRUCTIONS_AVAILABLE = 73

此 Arm 处理器实现 SME2.2 指令(FEAT_SME2p2)。

ARM_SME_AES_INSTRUCTIONS_AVAILABLE = 74

此 Arm 处理器在流式 SVE 模式下实现 SVE AES 指令(FEAT_SSVE_AES)。

ARM_SME_SBITPERM_INSTRUCTIONS_AVAILABLE = 75

此 Arm 处理器在流式 SVE 模式下实现 SVE 位排列指令(FEAT_SSVE_BitPerm)。

ARM_SME_SF8MM4_INSTRUCTIONS_AVAILABLE = 76

此 Arm 处理器在流式 SVE 模式下实现 SVE FMMLA(扩宽、四路、FP8 转 FP16)指令(FEAT_SSVE_F8F16MM)。

ARM_SME_SF8MM8_INSTRUCTIONS_AVAILABLE = 77

此 Arm 处理器在流式 SVE 模式下实现 SVE FMMLA 指令,即扩宽、8 路、FP8 到 FP32 的运算(FEAT_SSVE_F8F32MM)。

ARM_SME_SF8DP2_INSTRUCTIONS_AVAILABLE = 78

此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8DOT2 指令(FEAT_SSVE_FP8DOT2)。

ARM_SME_SF8DP4_INSTRUCTIONS_AVAILABLE = 79

此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8DOT4 指令(FEAT_SSVE_FP8DOT4)。

ARM_SME_SF8FMA_INSTRUCTIONS_AVAILABLE = 80

此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8FMA 指令(FEAT_SSVE_FP8FMA)。

ARM_SME_F8F32_INSTRUCTIONS_AVAILABLE = 81

此 Arm 处理器实现 SME F8F32 指令(FEAT_SME_F8F32)。

ARM_SME_F8F16_INSTRUCTIONS_AVAILABLE = 82

此 Arm 处理器实现 SME F8F16 指令(FEAT_SME_F8F16)。

ARM_SME_F16F16_INSTRUCTIONS_AVAILABLE = 83

此 Arm 处理器实现 SME F16F16 指令(FEAT_SME_F16F16)。

ARM_SME_B16B16_INSTRUCTIONS_AVAILABLE = 84

此 Arm 处理器实现 SME B16B16 指令(FEAT_SME_B16B16)。

ARM_SME_F64F64_INSTRUCTIONS_AVAILABLE = 85

此 Arm 处理器实现 SME F64F64 指令(FEAT_SME_F64F64)。

ARM_SME_I16I64_INSTRUCTIONS_AVAILABLE = 86

此 Arm 处理器实现 SME I16I64 指令(FEAT_SME_I16I64)。

ARM_SME_LUTv2_INSTRUCTIONS_AVAILABLE = 87

此 Arm 处理器实现 SME LUTv2 指令(FEAT_SME_LUTv2)。

ARM_SME_FA64_INSTRUCTIONS_AVAILABLE = 88

此 Arm 处理器实现 SME FA64(流式 SVE 模式下的完整 AArch64 指令集)(FEAT_SME_FA64)。

UMONITOR_INSTRUCTION_AVAILABLE = 89

此 x64 处理器实现了 UMONITOR 指令。

std.os.windows.PIMAGE_TLS_CALLBACK

类型

第 4310 行

std.os.windows.PPS_POST_PROCESS_INIT_ROUTINE

类型

第 5424 行

std.os.windows.PROC

类型

第 4044 行

std.os.windows.PROCESS

命名空间

第 1743 行

std.os.windows.PROCESS.BASIC_INFORMATION

容器

第 1832 行

字段

ExitStatus: NTSTATUS
PebBaseAddress: *PEB
AffinityMask: ULONG_PTR
BasePriority: KPRIORITY
UniqueProcessId: ULONG_PTR
InheritedFromUniqueProcessId: ULONG_PTR

std.os.windows.PROCESS.INFOCLASS

容器

第 1751 行

字段

BasicInformation = 0
QuotaLimits = 1
IoCounters = 2
VmCounters = 3
Times = 4
BasePriority = 5
RaisePriority = 6
DebugPort = 7
ExceptionPort = 8
AccessToken = 9
LdtInformation = 10
LdtSize = 11
DefaultHardErrorMode = 12
IoPortHandlers = 13
PooledUsageAndLimits = 14
WorkingSetWatch = 15
UserModeIOPL = 16
EnableAlignmentFaultFixup = 17
PriorityClass = 18
Wx86Information = 19
HandleCount = 20
AffinityMask = 21
PriorityBoost = 22
DeviceMap = 23
SessionInformation = 24
ForegroundInformation = 25
Wow64Information = 26
ImageFileName = 27
LUIDDeviceMapsEnabled = 28
BreakOnTermination = 29
DebugObjectHandle = 30
DebugFlags = 31
HandleTracing = 32
IoPriority = 33
ExecuteFlags = 34
TlsInformation = 35
Cookie = 36
ImageInformation = 37
CycleTime = 38
PagePriority = 39
InstrumentationCallback = 40
ThreadStackAllocation = 41
WorkingSetWatchEx = 42
ImageFileNameWin32 = 43
ImageFileMapping = 44
AffinityUpdateMode = 45
MemoryAllocationMode = 46
GroupInformation = 47
TokenVirtualizationEnabled = 48
OwnerInformation = 49
WindowInformation = 50
HandleInformation = 51
MitigationPolicy = 52
DynamicFunctionTableInformation = 53
HandleCheckingMode = 54
KeepAliveCount = 55
RevokeFileHandles = 56
WorkingSetControl = 57
HandleTable = 58
CheckStackExtentsMode = 59
CommandLineInformation = 60
ProtectionInformation = 61
MemoryExhaustion = 62
FaultInformation = 63
TelemetryIdInformation = 64
CommitReleaseInformation = 65
Reserved1Information = 66
Reserved2Information = 67
SubsystemProcess = 68
InPrivate = 70
RaiseUMExceptionOnInvalidHandleClose = 71
SubsystemInformation = 75
Win32kSyscallFilterInformation = 79
EnergyTrackingState = 82
NetworkIoCounters = 114
_

std.os.windows.PROCESS.INFOCLASS.Max

常量

第 1829 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.PROCESS.INFORMATION

容器

第 1744 行

字段

hProcess: HANDLE
hThread: HANDLE
dwProcessId: DWORD
dwThreadId: DWORD

std.os.windows.PROCESS.VM_COUNTERS

容器

第 1841 行

字段

PeakVirtualSize: SIZE_T
VirtualSize: SIZE_T
PageFaultCount: ULONG
PeakWorkingSetSize: SIZE_T
WorkingSetSize: SIZE_T
QuotaPeakPagedPoolUsage: SIZE_T
QuotaPagedPoolUsage: SIZE_T
QuotaPeakNonPagedPoolUsage: SIZE_T
QuotaNonPagedPoolUsage: SIZE_T
PagefileUsage: SIZE_T
PeakPagefileUsage: SIZE_T

std.os.windows.PROCESSOR_FEATURE_MAX

常量

第 5828 行

std.os.windows.PS

命名空间

第 26 行

std.os.windows.PS.ATTRIBUTE

容器

第 27 行

字段

Attribute: Type
Size: SIZE_T
u: extern union {
    Value: ULONG_PTR,
    ValuePtr: PVOID,
}
ReturnLength: ?*SIZE_T

std.os.windows.PS.ATTRIBUTE.LIST

容器

第 88 行

字段

TotalLength: SIZE_T
Attributes: [1]ATTRIBUTE

std.os.windows.PS.ATTRIBUTE.NUM

容器

第 38 行

https://ntdoc.m417z.com/ps_attribute_num 由于 PS_ATTRIBUTE_NUMBER_MASK 为 0xFFFF,标签类型为 u16

字段

ParentProcess = 0
DebugObject
Token
ClientId
TebAddress
ImageName
ImageInfo
MemoryReserve
PriorityClass
ErrorMode
StdHandleInfo
HandleList
GroupAffinity
PreferredNode
IdealProcessor
UmsThread
MitigationOptions
ProtectionLevel
SecureProcess
JobList
ChildProcessPolicy
AllApplicationPackagesPolicy
Win32kFilter
SafeOpenPromptOriginClaim
BnoIsolation
DesktopAppPolicy
Chpe
MitigationAuditOptions
MachineType
ComponentFilter
EnableOptionalXStateFeatures
SupportedMachines
SveVectorLength

std.os.windows.PS.ATTRIBUTE.Type

容器

第 75 行

字段

TEB_ADDRESS = construct(.TebAddress, true, false, false)
_

std.os.windows.PS.ATTRIBUTE.Type.construct

函数

第 79 行

pub fn construct(num: NUM, thread: bool, input: bool, additive: bool) ULONG_PTR

参数

num: NUM
thread: bool
input: bool
additive: bool

std.os.windows.PTSTR

常量

第 4085 行

std.os.windows.PVOID

类型

第 4052 行

std.os.windows.PWSTR

类型

第 4053 行

std.os.windows.REG

命名空间

第 4401 行

REG_ 命名空间非常拥挤,Windows 头文件中有很多相互重叠且无关的 定义,因此此处不严格照搬 Windows 头文件名称, 而是添加额外命名空间以提高可读性。

std.os.windows.REG.LoadOptions

容器

第 4446 行

与 NtLoadKeyEx 配合使用,也可能用于其他调用

字段

WHOLE_HIVE_VOLATILE: bool = false

将整个配置单元恢复为易失形式

REFRESH_HIVE: bool = false

将更改回退到上次刷新的状态

NO_LAZY_FLUSH: bool = false

始终禁止延迟刷新此配置单元

FORCE_RESTORE: bool = false

即使仍有子键句柄处于打开状态,也强制执行还原

APP_HIVE: bool = false

加载对调用进程可见的注册表配置单元

PROCESS_PRIVATE: bool = false

配置单元使用期间,其他进程无法挂载它

START_JOURNAL: bool = false

启动配置单元日志

HIVE_EXACT_FILE_GROWTH: bool = false

以恰好 4k 的增量扩展注册表配置单元文件

HIVE_NO_RM: bool = false

未为此配置单元启动资源管理器(无事务)

HIVE_SINGLE_LOG: bool = false

此配置单元使用旧式单日志记录

BOOT_HIVE: bool = false

此注册表配置单元可能被操作系统加载器使用

LOAD_HIVE_OPEN_HANDLE: bool = false

加载配置单元,并返回其根 kcb 的句柄

FLUSH_HIVE_FILE_GROWTH: bool = false

每次刷新时,同时将主配置单元文件大小的更改刷新到磁盘

OPEN_READ_ONLY: bool = false

以只读模式打开配置单元的文件。 REG_APP_HIVE_OPEN_READ_ONLY 使用相同标志: 若应用配置单元此前尚未加载,则以只读模式打开其文件。

IMMUTABLE: bool = false

加载配置单元,但不允许进行任何修改

NO_IMPERSONATION_FALLBACK: bool = false

如果配置单元文件访问失败,不要回退为模拟调用方。

Reserved16: u16 = 0

std.os.windows.REG.OpenOptions

容器

第 4435 行

与 NtOpenKeyEx 配合使用,或许也用于其他调用

字段

Reserved0: u2 = 0
BACKUP_RESTORE: bool = false

为备份或还原而打开 特殊访问规则需要相应特权

OPEN_LINK: bool = false

打开符号链接

Reserved3: u28 = 0

std.os.windows.REG.ValueType

容器

第 4402 行

字段

NONE = 0

无值类型

SZ = 1

以空字符终止的 Unicode 字符串

EXPAND_SZ = 2

以空字符结尾的 Unicode 字符串(包含环境变量引用)。

BINARY = 3

自由形式的二进制数据

DWORD = 4

32 位数

DWORD_BIG_ENDIAN = 5

32 位数

LINK = 6

符号链接(Unicode)

MULTI_SZ = 7

多个 Unicode 字符串

RESOURCE_LIST = 8

资源映射中的资源列表

FULL_RESOURCE_DESCRIPTOR = 9

硬件描述中的资源列表

RESOURCE_REQUIREMENTS_LIST = 10
QWORD = 11

64 位数字

_

std.os.windows.REG.ValueType.DWORD_LITTLE_ENDIAN

常量

第 4429 行

32 位数值(等同于 REG_DWORD)

ValueType

std.os.windows.REG.ValueType.QWORD_LITTLE_ENDIAN

常量

第 4431 行

64 位数(同 REG_QWORD)

ValueType

std.os.windows.REGSAM

别名

第 4312 行

别名目标 std.os.windows.ACCESS_MASK

std.os.windows.relocateCsrssAddress

函数

第 6053 行

接受共享内存区域在 CSRSS 地址空间映射视图中的地址, 返回该共享内存区域在本进程映射视图中的对应地址。

fn relocateCsrssAddress(addr: u64) *const anyopaque

参数

addr: u64

std.os.windows.RemoveDotDirsError

错误集合

第 3828 行

removeDotDirsSanitized 的错误类型

错误

TooManyParentDirs

std.os.windows.removeDotDirsSanitized

函数

第 3835 行

从“已清理的相对路径”中移除点和双点路径分量。 “已清理路径”指: 1)所有正斜杠均已替换为反斜杠; 2)所有重复反斜杠均已合并; 3)路径为相对路径,即不以反斜杠开头。

pub fn removeDotDirsSanitized(comptime T: type, path: []T) RemoveDotDirsError!usize

参数

T: type
path: []T

错误

TooManyParentDirs

std.os.windows.REPARSE_DATA_BUFFER

容器

第 5503 行

字段

ReparseTag: IO_REPARSE_TAG
ReparseDataLength: USHORT
Reserved: USHORT
DataBuffer: [1]UCHAR

std.os.windows.RTL_BITMAP

容器

第 5026 行

std.os.windows.RTL_CRITICAL_SECTION

容器

第 4543 行

字段

DebugInfo: *RTL_CRITICAL_SECTION_DEBUG
LockCount: LONG
RecursionCount: LONG
OwningThread: HANDLE
LockSemaphore: HANDLE
SpinCount: ULONG_PTR

std.os.windows.RTL_CRITICAL_SECTION_DEBUG

容器

第 4531 行

字段

Type: WORD
CreatorBackTraceIndex: WORD
CriticalSection: *RTL_CRITICAL_SECTION
ProcessLocksList: LIST_ENTRY
EntryCount: DWORD
ContentionCount: DWORD
Flags: DWORD
CreatorBackTraceIndexHigh: WORD
SpareWORD: WORD

std.os.windows.RTL_DRIVE_LETTER_CURDIR

容器

第 5417 行

字段

Flags: c_ushort
Length: c_ushort
TimeStamp: ULONG
DosPath: UNICODE_STRING

std.os.windows.RTL_OSVERSIONINFOW

别名

第 5501 行

别名目标 std.os.windows.OSVERSIONINFOW

std.os.windows.RTL_QUERY_REGISTRY_DELETE

常量

第 4391 行

用于在查询后删除值键。

std.os.windows.RTL_QUERY_REGISTRY_DIRECT

常量

第 4388 行

忽略 QueryRoutine 字段。EntryContext 字段指向存储值的位置。 对于以空字符结尾的字符串,EntryContext 指向 UNICODE_STRING 结构体, 描述缓冲区的最大大小。如果 .Buffer 字段为 NULL,则 分配缓冲区。

std.os.windows.RTL_QUERY_REGISTRY_NOEXPAND

常量

第 4382 行

用于禁止将 REG_MULTI_SZ 展开为多次回调, 或阻止展开 REG_EXPAND_SZ 中的环境变量值。

std.os.windows.RTL_QUERY_REGISTRY_NOVALUE

常量

第 4378 行

标记没有值名称的表项,仅要求一次回调, 而非枚举全部值。

std.os.windows.RTL_QUERY_REGISTRY_REQUIRED

常量

第 4374 行

若未找到与此表条目匹配的项则失败。

std.os.windows.RTL_QUERY_REGISTRY_ROUTINE

类型

第 4338 行

std.os.windows.RTL_QUERY_REGISTRY_SUBKEY

常量

第 4368 行

Name 是子键;表中剩余部分或直到下一个子键之前的内容, 是要在该子键中查找的值名。

std.os.windows.RTL_QUERY_REGISTRY_TABLE

容器

第 4328 行

字段

QueryRoutine: RTL_QUERY_REGISTRY_ROUTINE
Flags: ULONG
Name: ?PWSTR
EntryContext: ?*anyopaque
DefaultType: REG.ValueType
DefaultData: ?*anyopaque
DefaultLength: ULONG

std.os.windows.RTL_QUERY_REGISTRY_TOPKEY

常量

第 4371 行

将此表条目及所有后续条目的当前键重置为原始键。

std.os.windows.RTL_QUERY_REGISTRY_TYPECHECK

常量

第 4396 行

将此标志与 RTL_QUERY_REGISTRY_DIRECT 标志组合,验证存储的注册表值的 REG_XXX 类型是否与调用者预期类型一致。 若不匹配,则调用失败。

std.os.windows.RTL_REGISTRY_ABSOLUTE

常量

第 4348 行

路径是完整路径

std.os.windows.RTL_REGISTRY_CONTROL

常量

第 4352 行

\Registry\Machine\System\CurrentControlSet\Control

std.os.windows.RTL_REGISTRY_DEVICEMAP

常量

第 4356 行

\Registry\Machine\Hardware\DeviceMap

std.os.windows.RTL_REGISTRY_HANDLE

常量

第 4362 行

低位存储注册表句柄

std.os.windows.RTL_REGISTRY_MAXIMUM

常量

第 4359 行

std.os.windows.RTL_REGISTRY_OPTIONAL

常量

第 4364 行

表示键节点为可选

std.os.windows.RTL_REGISTRY_SERVICES

常量

第 4350 行

\Registry\Machine\System\CurrentControlSet\Services

std.os.windows.RTL_REGISTRY_USER

常量

第 4358 行

\Registry\User\CurrentUser

std.os.windows.RTL_REGISTRY_WINDOWS_NT

常量

第 4354 行

\Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion

std.os.windows.RTL_RUN_ONCE

容器

第 4557 行

字段

Ptr: ?*anyopaque

std.os.windows.RTL_RUN_ONCE_INIT

常量

第 4561 行

std.os.windows.RTL_USER_PROCESS_PARAMETERS

容器

第 5382 行

字段

AllocationSize: ULONG
Size: ULONG
Flags: ULONG
DebugFlags: ULONG
ConsoleHandle: HANDLE
ConsoleFlags: ULONG
hStdInput: HANDLE
hStdOutput: HANDLE
hStdError: HANDLE
CurrentDirectory: CURDIR
DllPath: UNICODE_STRING
ImagePathName: UNICODE_STRING
CommandLine: UNICODE_STRING
Environment: [*:0]WCHAR

指向以 NUL 终止的序列,其中每项均为以 NUL 终止、 采用 WTF-16 LE 编码的 name=value 序列。 使用字符串字面量语法的示例: "NAME=value\x00foo=bar\x00\x00"

dwX: ULONG
dwY: ULONG
dwXSize: ULONG
dwYSize: ULONG
dwXCountChars: ULONG
dwYCountChars: ULONG
dwFillAttribute: ULONG
dwFlags: ULONG
dwShowWindow: ULONG
WindowTitle: UNICODE_STRING
Desktop: UNICODE_STRING
ShellInfo: UNICODE_STRING
RuntimeInfo: UNICODE_STRING
DLCurrentDirectory: [0x20]RTL_DRIVE_LETTER_CURDIR

std.os.windows.RUNTIME_FUNCTION

类型

第 4896 行

std.os.windows.SEC

容器

第 3496 行

字段

Reserved0: u17 = 0
HUGE_PAGES: bool = false
PARTITION_OWNER_HANDLE: bool = false
@"64K_PAGES": bool = false
Reserved19: u3 = 0
FILE: bool = false
IMAGE: bool = false
PROTECTED_IMAGE: bool = false
RESERVE: bool = false
COMMIT: bool = false
NOCACHE: bool = false
Reserved29: u1 = 0
WRITECOMBINE: bool = false
LARGE_PAGES: bool = false

std.os.windows.SEC.IMAGE_NO_EXECUTE

常量

第 3512 行

SEC

std.os.windows.SECTION_INHERIT

容器

第 3370 行

字段

Share = 1
Unmap = 2

std.os.windows.SECURITY_ATTRIBUTES

容器

第 4168 行

字段

nLength: DWORD
lpSecurityDescriptor: ?*anyopaque
bInheritHandle: BOOL

std.os.windows.SharedUserData

常量

第 5992 行

*const KUSER_SHARED_DATA

std.os.windows.SHORT

类型

第 4069 行

std.os.windows.SIZE_T

类型

第 4057 行

std.os.windows.SRWLOCK

容器

第 5556 行

字段

Ptr: ?PVOID = null

std.os.windows.SRWLOCK_INIT

常量

第 5555 行

std.os.windows.STARTF_FORCEOFFFEEDBACK

常量

第 4196 行

std.os.windows.STARTF_FORCEONFEEDBACK

常量

第 4195 行

std.os.windows.STARTF_PREVENTPINNING

常量

第 4197 行

std.os.windows.STARTF_RUNFULLSCREEN

常量

第 4198 行

std.os.windows.STARTF_TITLEISAPPID

常量

第 4199 行

std.os.windows.STARTF_TITLEISLINKNAME

常量

第 4200 行

std.os.windows.STARTF_UNTRUSTEDSOURCE

常量

第 4201 行

std.os.windows.STARTF_USECOUNTCHARS

常量

第 4202 行

std.os.windows.STARTF_USEFILLATTRIBUTE

常量

第 4203 行

std.os.windows.STARTF_USEHOTKEY

常量

第 4204 行

std.os.windows.STARTF_USEPOSITION

常量

第 4205 行

std.os.windows.STARTF_USESHOWWINDOW

常量

第 4206 行

std.os.windows.STARTF_USESIZE

常量

第 4207 行

std.os.windows.STARTF_USESTDHANDLES

常量

第 4208 行

std.os.windows.STARTUPINFOW

容器

第 4174 行

字段

cb: DWORD
lpReserved: ?LPWSTR
lpDesktop: ?LPWSTR
lpTitle: ?LPWSTR
dwX: DWORD
dwY: DWORD
dwXSize: DWORD
dwYSize: DWORD
dwXCountChars: DWORD
dwYCountChars: DWORD
dwFillAttribute: DWORD
dwFlags: DWORD
wShowWindow: WORD
cbReserved2: WORD
lpReserved2: ?*BYTE
hStdInput: ?HANDLE
hStdOutput: ?HANDLE
hStdError: ?HANDLE

std.os.windows.statusBug

函数

第 4001 行

pub fn statusBug(status: NTSTATUS) UnexpectedError

参数

status: NTSTATUS

std.os.windows.std

别名

第 10 行

别名目标 std

std.os.windows.STRING

类型函数

第 4088 行

fn STRING(comptime C: type) type

参数

C: type

字段

Length: USHORT
MaximumLength: USHORT
Buffer: ?[*]C

std.os.windows.STRING.empty

常量

第 4094 行

@This()

std.os.windows.STRING.init

函数

第 4096 行

pub fn init(string: []const C) @This()

参数

string: []const C

std.os.windows.STRING.initZ

函数

第 4105 行

pub fn initZ(string: [:0]const C) @This()

参数

string: [:0]const C

std.os.windows.STRING.isEmpty

函数

第 4114 行

pub fn isEmpty(string: *const @This()) bool

参数

string: *const @This()

std.os.windows.STRING.slice

函数

第 4118 行

pub fn slice(string: *const @This()) []C

参数

string: *const @This()

std.os.windows.STRING.sliceZ

函数

第 4122 行

pub fn sliceZ(string: *const @This()) [:0]C

参数

string: *const @This()

std.os.windows.SUBLANG

别名

第 4023 行

别名目标 std.os.windows.sublang

std.os.windows.SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE

常量

第 5527 行

DWORD

std.os.windows.SYMBOLIC_LINK_FLAG_DIRECTORY

常量

第 5526 行

DWORD

std.os.windows.SYMBOLIC_LINK_REPARSE_BUFFER

容器

第 5509 行

字段

SubstituteNameOffset: USHORT
SubstituteNameLength: USHORT
PrintNameOffset: USHORT
PrintNameLength: USHORT
Flags: ULONG
PathBuffer: [1]WCHAR

std.os.windows.SYMLINK_FLAG_RELATIVE

常量

第 5524 行

ULONG

std.os.windows.SYSTEM

命名空间

第 1712 行

std.os.windows.SYSTEM.BASIC_INFORMATION

容器

第 1728 行

字段

Reserved: ULONG
TimerResolution: ULONG
PageSize: ULONG
NumberOfPhysicalPages: ULONG
LowestPhysicalPageNumber: ULONG
HighestPhysicalPageNumber: ULONG
AllocationGranularity: ULONG
MinimumUserModeAddress: ULONG_PTR
MaximumUserModeAddress: ULONG_PTR
ActiveProcessorsAffinityMask: KAFFINITY
NumberOfProcessors: UCHAR

std.os.windows.SYSTEM.INFORMATION_CLASS

容器

第 1713 行

字段

Basic = 0
Performance = 2
TimeOfDay = 3
Process = 5
ProcessorPerformance = 8
Interrupt = 23
Exception = 33
RegistryQuota = 37
Lookaside = 45
CodeIntegrity = 103
Policy = 134
_

std.os.windows.TCHAR

常量

第 4082 行

std.os.windows.TDI

命名空间

第 1326 行

std.os.windows.TDI.ADDRESS

命名空间

第 1345 行

std.os.windows.TDI.ADDRESS.IP

容器

第 1399 行

字段

sin_port: USHORT
in_addr: ULONG
sin_zero: [8]UCHAR

std.os.windows.TDI.ADDRESS.IP6

容器

第 1404 行

字段

sin_port: USHORT
flowinfo: ULONG
addr: [8]USHORT
scope_id: ULONG

std.os.windows.TDI.ADDRESS.TYPE

容器

第 1346 行

字段

UNSPEC = 0

未指定

UNIX = 1

主机本地(管道、门户,

IP = 2

网际互连:UDP、TCP 等。

IMPLINK = 3

arpanet imp 地址

PUP = 4

PUP 协议,例如 BSP

CHAOS = 5

MIT CHAOS 协议

NS = 6

XEROX NS 协议

IPX = 6

Netware IPX

NBS = 7

NBS 协议

ECMA = 8

欧洲计算机制造商

DATAKIT = 9

datakit 协议

CCITT = 10

CCITT 协议,如 X.25 等

SNA = 11

IBM SNA

DECnet = 12

DECnet

DLI = 13

直接数据链路接口

LAT = 14

LAT

HYLINK = 15

NSC Hyperchannel

APPLETALK = 16

AppleTalk

NETBIOS = 17

Netbios 地址

@"8022" = 18
OSI_TSAP = 19
NETONE = 20

用于 WzMail

VNS = 21

Banyan VINES IP

NETBIOS_EX = 22

NETBIOS 地址扩展

IP6 = 23

IP 版本 6

NETBIOS_UNICODE_EX = 24

WCHAR Netbios 地址

_

std.os.windows.TDI.CONNECTION

命名空间

第 1328 行

std.os.windows.TDI.CONNECTION.CONTEXT

别名

第 1329 行

别名目标 std.os.windows.PVOID

std.os.windows.TDI.CONNECTION.INFORMATION

容器

第 1330 行

字段

UserDataLength: LONG

用户数据缓冲区长度

UserData: PVOID

指向用户数据缓冲区的指针

OptionsLength: LONG

后续缓冲区的长度

Options: PVOID

指向含选项的缓冲区的指针

RemoteAddressLength: LONG

后续缓冲区的长度

RemoteAddress: PVOID

包含远程地址的缓冲区

std.os.windows.TDI.RECEIVE

容器

第 1467 行

字段

Reserved0: u2 = 0
BROADCAST: bool = false
MULTICAST: bool = false
PARTIAL: bool = false
NORMAL: bool = false
EXPEDITED: bool = false
PEEK: bool = false
NO_RESPONSE_EXP: bool = false
COPY_LOOKAHEAD: bool = false
ENTIRE_MESSAGE: bool = false
AT_DISPATCH_LEVEL: bool = false
CONTROL_INFO: bool = false
FORCE_INDICATION: bool = false
NO_PUSH: bool = false
Reserved12: u17 = 0

std.os.windows.TDI.REQUEST

容器

第 1411 行

字段

Handle: extern union {
    AddressHandle: HANDLE,
    ConnectionContext: CONNECTION.CONTEXT,
    ControlChannel: HANDLE,
}
RequestNotifyObject: PVOID
RequestContext: PVOID
TdiStatus: TDI.STATUS

std.os.windows.TDI.REQUEST.ACCEPT

容器

第 1439 行

字段

Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION

std.os.windows.TDI.REQUEST.ASSOCIATE

容器

第 1429 行

字段

Request: REQUEST
AddressHandle: HANDLE

std.os.windows.TDI.REQUEST.CONNECT

容器

第 1433 行

字段

Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION
Timeout: LARGE_INTEGER

std.os.windows.TDI.REQUEST.DISCONNECT

容器

第 1450 行

字段

Request: REQUEST
Timeout: LARGE_INTEGER

std.os.windows.TDI.REQUEST.LISTEN

容器

第 1444 行

字段

Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION
ListenFlags: USHORT

std.os.windows.TDI.REQUEST.RECEIVE

容器

第 1458 行

字段

Request: REQUEST
ReceiveFlags: USHORT

std.os.windows.TDI.REQUEST.SEND

容器

第 1454 行

字段

Request: REQUEST
SendFlags: USHORT

std.os.windows.TDI.REQUEST.SEND_DATAGRAM

容器

第 1462 行

字段

Request: REQUEST
SendDatagramInformation: *CONNECTION.INFORMATION

std.os.windows.TDI.REQUEST.STATUS

容器

第 1421 行

字段

Status: TDI.STATUS

请求完成状态

RequestContext: PVOID

请求上下文

BytesTransferred: ULONG

请求中传输的字节数

std.os.windows.TDI.SEND

容器

第 1484 行

字段

Reserved0: u5 = 0
EXPEDITED: bool = false
PARTIAL: bool = false
NO_RESPONSE_EXPECTED: bool = false
NON_BLOCKING: bool = false
AND_DISCONNECT: bool = false
Reserved10: u22 = 0

std.os.windows.TDI.STATUS

别名

第 1327 行

别名目标 std.os.windows.NTSTATUS

std.os.windows.teb

函数

第 3657 行

pub fn teb() *TEB

std.os.windows.TEB

容器

第 5035 行

字段

NtTib: NT_TIB
EnvironmentPointer: PVOID
ClientId: CLIENT_ID
ActiveRpcHandle: PVOID
ThreadLocalStoragePointer: PVOID
ProcessEnvironmentBlock: *PEB
LastErrorValue: Win32Error
Reserved2: [399 * @sizeOf(PVOID) - @sizeOf(ULONG)]u8
Reserved3: [1952]u8
TlsSlots: [64]PVOID
Reserved4: [8]u8
Reserved5: [26]PVOID
ReservedForOle: PVOID
Reserved6: [4]PVOID
TlsExpansionSlots: PVOID

std.os.windows.teb.zig_windows_teb

函数

第 3661 行

这是 C 后端的临时规避措施,直到 zig 能够将 C 代码放入内联汇编。

extern fn zig_windows_teb() callconv(.c) *anyopaque

std.os.windows.testEqlIgnoreCase

函数

第 3807 行

fn testEqlIgnoreCase(comptime expect_eql: bool, comptime a: []const u8, comptime b: []const u8) !void

参数

expect_eql: bool
a: []const u8
b: []const u8

std.os.windows.THREAD

命名空间

第 1856 行

std.os.windows.THREAD_START_ROUTINE

常量

第 4210 行

std.os.windows.THREAD.BASIC_INFORMATION

容器

第 1914 行

字段

ExitStatus: NTSTATUS
TebBaseAddress: PVOID
ClientId: CLIENT_ID
AffinityMask: KAFFINITY
Priority: KPRIORITY
BasePriority: KPRIORITY

std.os.windows.THREAD.CREATE_FLAGS

容器

第 1923 行

字段

CREATE_SUSPENDED: bool = false
SKIP_THREAD_ATTACH: bool = false
HIDE_FROM_DEBUGGER: bool = false
LOADER_WORKER: bool = false
SKIP_LOADER_INIT: bool = false
BYPASS_PROCESS_FREEZE: bool = false
Reserved6: u26 = 0

std.os.windows.THREAD.CREATE_FLAGS.NONE

常量

第 1932 行

CREATE_FLAGS

std.os.windows.THREAD.INFOCLASS

容器

第 1857 行

字段

BasicInformation = 0
Times = 1
Priority = 2
BasePriority = 3
AffinityMask = 4
ImpersonationToken = 5
DescriptorTableEntry = 6
EnableAlignmentFaultFixup = 7
EventPair_Reusable = 8
QuerySetWin32StartAddress = 9
ZeroTlsCell = 10
PerformanceCount = 11
AmILastThread = 12
IdealProcessor = 13
PriorityBoost = 14
SetTlsArrayAddress = 15
IsIoPending = 16
HideFromDebugger = 17
BreakOnTermination = 18
SwitchLegacyState = 19
IsTerminated = 20
LastSystemCall = 21
IoPriority = 22
CycleTime = 23
PagePriority = 24
ActualBasePriority = 25
TebInformation = 26
CSwitchMon = 27
CSwitchPmu = 28
Wow64Context = 29
GroupInformation = 30
UmsInformation = 31
CounterProfiling = 32
IdealProcessorEx = 33
CpuAccountingInformation = 34
SuspendCount = 35
HeterogeneousCpuPolicy = 36
ContainerId = 37
NameInformation = 38
SelectedCpuSets = 39
SystemThreadInformation = 40
ActualGroupAffinity = 41
DynamicCodePolicyInfo = 42
SubsystemInformation = 45
_

std.os.windows.THREAD.INFOCLASS.Max

常量

第 1911 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.THREAD.StackSize

容器

第 1935 行

字段

default = 0

可执行文件头部指定的默认大小

_

std.os.windows.TIMER_TYPE

容器

第 3560 行

字段

Notification
Synchronization

std.os.windows.TLS_OUT_OF_INDEXES

常量

第 4298 行

std.os.windows.toSysTime

函数

第 3737 行

pub fn toSysTime(ns: Io.Timestamp) i64

参数

std.os.windows.toUpperWtf16

函数

第 3744 行

Windows 上且不在编译期时使用 RtlUpcaseUnicodeChar, 避免包含冗余的大写字符数据副本。

pub inline fn toUpperWtf16(c: u16) u16

参数

c: u16

std.os.windows.UCHAR

类型

第 4029 行

std.os.windows.UINT

类型

第 4058 行

std.os.windows.ULARGE_INTEGER

类型

第 4067 行

std.os.windows.ULONG

类型

第 4070 行

std.os.windows.ULONG_PTR

类型

第 4059 行

std.os.windows.ULONG64

类型

第 4072 行

std.os.windows.ULONGLONG

类型

第 4073 行

std.os.windows.unexpectedError

函数

第 3979 行

调用 Windows DLL 或其他会设置 SetLastError 的函数后, 遇到意外错误时调用此函数。

pub fn unexpectedError(err: Win32Error) UnexpectedError

参数

err: Win32Error

std.os.windows.UnexpectedError

别名

第 16 行

别名目标 std.posix.UnexpectedError

std.os.windows.unexpectedStatus

函数

第 3990 行

调用 Windows NtDll 后得到意外状态时,调用此函数。

pub fn unexpectedStatus(status: NTSTATUS) UnexpectedError

参数

status: NTSTATUS

std.os.windows.UNICODE_STRING

类型

第 4129 行

std.os.windows.UNW_FLAG_CHAININFO

常量

第 5021 行

std.os.windows.UNW_FLAG_EHANDLER

常量

第 5019 行

std.os.windows.UNW_FLAG_NHANDLER

常量

第 5018 行

std.os.windows.UNW_FLAG_UHANDLER

常量

第 5020 行

std.os.windows.UNWIND_HISTORY_TABLE

容器

第 5007 行

字段

Count: ULONG
LocalHint: BYTE
GlobalHint: BYTE
Search: BYTE
Once: BYTE
LowAddress: ULONG64
HighAddress: ULONG64
Entry: [UNWIND_HISTORY_TABLE_SIZE]UNWIND_HISTORY_TABLE_ENTRY

std.os.windows.UNWIND_HISTORY_TABLE_ENTRY

容器

第 5002 行

字段

ImageBase: ULONG64
FunctionEntry: *RUNTIME_FUNCTION

std.os.windows.UNWIND_HISTORY_TABLE_SIZE

常量

第 5001 行

std.os.windows.USER_THREAD_START_ROUTINE

常量

第 4211 行

std.os.windows.USHORT

类型

第 4068 行

std.os.windows.va_list

类型

第 4080 行

std.os.windows.VECTORED_EXCEPTION_HANDLER

类型

第 4991 行

std.os.windows.VIRTUAL_MEMORY

命名空间

第 3520 行

std.os.windows.VIRTUAL_MEMORY.INFORMATION_CLASS

容器

第 3521 行

字段

Prefetch = 0
PagePriority = 1
CfgCallTarget = 2
PageDirtyState = 3
ImageHotPatch = 4
PhysicalContiguity = 5
VirtualMachinePrepopulate = 6
RemoveFromWorkingSet = 7
_

std.os.windows.VIRTUAL_MEMORY.INFORMATION_CLASS.Max

常量

第 3532 行

@typeInfo(@This()).@"enum".tag_type

std.os.windows.VIRTUAL_MEMORY.MEMORY_PREFETCH_INFORMATION

容器

第 3535 行

字段

Flags: VM_PREFETCH

std.os.windows.VIRTUAL_MEMORY.MEMORY_PREFETCH_INFORMATION.VM_PREFETCH

容器

第 3538 行

字段

TO_WORKING_SET: bool

Windows 11 24H4 引入。 尝试将指定的一个或多个地址范围放入进程工作集,即将页面载入物理内存。

Reserved1: u31 = 0

std.os.windows.WAIT_TYPE

容器

第 3565 行

字段

All
Any

std.os.windows.WCHAR

类型

第 4062 行

std.os.windows.Win32Error

别名

第 4021 行

别名目标 std.os.windows.win32error.Win32Error

std.os.windows.WORD

类型

第 4063 行

std.os.windows.ws2_32

别名

第 20 行

别名目标 std.os.windows.ws2_32

std.os.windows.wtf8ToWtf16Le

函数

第 6007 行

pub fn wtf8ToWtf16Le(wtf16le: []u16, wtf8: []const u8) error{ BadPathName, NameTooLong }!usize

参数

wtf16le: []u16
wtf8: []const u8

错误

BadPathName
NameTooLong

std.os.windows.XMM_SAVE_AREA32

类型

第 4625 行

std.os.windows.XSTATE_CONFIGURATION

容器

第 5854 行

字段

EnabledFeatures: ULONG64
Size: ULONG
OptimizedSave: ULONG
Features: [MAXIMUM_XSTATE_FEATURES]XSTATE_FEATURE

std.os.windows.XSTATE_FEATURE

容器

第 5849 行

字段

Offset: ULONG
Size: ULONG
源码

std/os/windows.zig

//! 此文件为 Windows 专有接口提供轻量封装,具体
//! 目标如下:
//! * 将“errno”风格的错误码转换为 Zig 错误。
//! * 在需要空字符结尾或 WTF16LE 字节缓冲区时,既提供接受
//!   切片的接口,也提供接受空字符结尾的 WTF16LE 字节缓冲区的接口。

const builtin = @import("builtin");
const native_arch = builtin.cpu.arch;

const std = @import("../std.zig");
const Io = std.Io;
const mem = std.mem;
const assert = std.debug.assert;
const math = std.math;
const maxInt = std.math.maxInt;
const UnexpectedError = std.posix.UnexpectedError;

pub const kernel32 = @import("windows/kernel32.zig");
pub const ntdll = @import("windows/ntdll.zig");
pub const ws2_32 = @import("windows/ws2_32.zig");
pub const crypt32 = @import("windows/crypt32.zig");
pub const nls = @import("windows/nls.zig");

pub const current_process: HANDLE = @ptrFromInt(@as(usize, @bitCast(@as(isize, -1))));

pub const PS = struct {
    pub const ATTRIBUTE = extern struct {
        Attribute: Type,
        Size: SIZE_T,
        u: extern union {
            Value: ULONG_PTR,
            ValuePtr: PVOID,
        },
        ReturnLength: ?*SIZE_T,

        /// https://ntdoc.m417z.com/ps_attribute_num
        /// 由于 PS_ATTRIBUTE_NUMBER_MASK 为 0xFFFF,标签类型为 `u16`
        pub const NUM = enum(u16) {
            ParentProcess = 0,
            DebugObject,
            Token,
            ClientId,
            TebAddress,
            ImageName,
            ImageInfo,
            MemoryReserve,
            PriorityClass,
            ErrorMode,
            StdHandleInfo,
            HandleList,
            GroupAffinity,
            PreferredNode,
            IdealProcessor,
            UmsThread,
            MitigationOptions,
            ProtectionLevel,
            SecureProcess,
            JobList,
            ChildProcessPolicy,
            AllApplicationPackagesPolicy,
            Win32kFilter,
            SafeOpenPromptOriginClaim,
            BnoIsolation,
            DesktopAppPolicy,
            Chpe,
            MitigationAuditOptions,
            MachineType,
            ComponentFilter,
            EnableOptionalXStateFeatures,
            SupportedMachines,
            SveVectorLength,
        };

        /// https://ntdoc.m417z.com/psattributevalue
        pub const Type = enum(ULONG_PTR) {
            TEB_ADDRESS = construct(.TebAddress, true, false, false),
            _,

            pub fn construct(num: NUM, thread: bool, input: bool, additive: bool) ULONG_PTR {
                var val: ULONG_PTR = @backingInt(num);
                if (thread) val |= 0x10000;
                if (input) val |= 0x20000;
                if (additive) val |= 0x40000;
                return val;
            }
        };

        pub const LIST = extern struct {
            TotalLength: SIZE_T,
            Attributes: [1]ATTRIBUTE,
        };
    };
};

pub const OBJECT = struct {
    // 参考:um/winternl.h

    pub const ATTRIBUTES = extern struct {
        Length: ULONG = @sizeOf(ATTRIBUTES),
        RootDirectory: ?HANDLE = null,
        ObjectName: ?*UNICODE_STRING = @constCast(&UNICODE_STRING.empty),
        Attributes: Flags = .{},
        SecurityDescriptor: ?*anyopaque = null,
        SecurityQualityOfService: ?*anyopaque = null,

        // Attributes 字段的有效取值
        pub const Flags = packed struct(ULONG) {
            Reserved0: u1 = 0,
            INHERIT: bool = false,
            Reserved2: u2 = 0,
            PERMANENT: bool = false,
            EXCLUSIVE: bool = false,
            /// 名称查找代码是否应忽略 ObjectName 成员的大小写,而非执行精确匹配搜索。
            CASE_INSENSITIVE: bool = true,
            OPENIF: bool = false,
            OPENLINK: bool = false,
            KERNEL_HANDLE: bool = false,
            FORCE_ACCESS_CHECK: bool = false,
            IGNORE_IMPERSONATED_DEVICEMAP: bool = false,
            DONT_REPARSE: bool = false,
            Reserved13: u19 = 0,

            pub const VALID_ATTRIBUTES: ATTRIBUTES = .{
                .INHERIT = true,
                .PERMANENT = true,
                .EXCLUSIVE = true,
                .CASE_INSENSITIVE = true,
                .OPENIF = true,
                .OPENLINK = true,
                .KERNEL_HANDLE = true,
                .FORCE_ACCESS_CHECK = true,
                .IGNORE_IMPERSONATED_DEVICEMAP = true,
                .DONT_REPARSE = true,
            };
        };
    };

    pub const INFORMATION_CLASS = enum(c_int) {
        Basic = 0,
        Name = 1,
        Type = 2,
        Types = 3,
        HandleFlag = 4,
        Session = 5,
        _,

        pub const Max: @typeInfo(@This()).@"enum".tag_type = @typeInfo(@This()).@"enum".field_names.len;
    };

    pub const BASIC_INFORMATION = extern struct {
        Attributes: ATTRIBUTES.Flags,
        GrantedAccess: ACCESS_MASK,
        HandleCount: ULONG,
        PointerCount: ULONG,
        Reserved: [10]ULONG,
    };

    pub const NAME_INFORMATION = extern struct {
        Name: UNICODE_STRING,
    };

    pub const HANDLE_FLAG = packed struct(USHORT) {
        INHERIT: bool = false,
        PROTECT_FROM_CLOSE: bool = false,
        Reserved1: u14 = 0,
    };
};

pub const FILE = struct {
    // 参考:km/ntddk.h

    pub const END_OF_FILE_INFORMATION = extern struct {
        EndOfFile: LARGE_INTEGER,
    };

    pub const ALIGNMENT_INFORMATION = extern struct {
        AlignmentRequirement: ULONG,
    };

    pub const NAME_INFORMATION = extern struct {
        FileNameLength: ULONG,
        FileName: [1]WCHAR,
    };

    pub const DISPOSITION = packed struct(ULONG) {
        DELETE: bool = false,
        POSIX_SEMANTICS: bool = false,
        FORCE_IMAGE_SECTION_CHECK: bool = false,
        ON_CLOSE: bool = false,
        IGNORE_READONLY_ATTRIBUTE: bool = false,
        Reserved5: u27 = 0,

        pub const DO_NOT_DELETE: DISPOSITION = .{};

        pub const INFORMATION = extern struct {
            DeleteFile: BOOLEAN,

            pub const EX = extern struct {
                Flags: DISPOSITION,
            };
        };
    };

    pub const FS_VOLUME_INFORMATION = extern struct {
        VolumeCreationTime: LARGE_INTEGER,
        VolumeSerialNumber: ULONG,
        VolumeLabelLength: ULONG,
        SupportsObjects: BOOLEAN,
        VolumeLabel: [0]WCHAR,

        pub fn getVolumeLabel(fvi: *const FS_VOLUME_INFORMATION) []const WCHAR {
            return (&fvi).ptr[0..@divExact(fvi.VolumeLabelLength, @sizeOf(WCHAR))];
        }
    };

    // 参考:km/ntifs.h

    pub const NAME_FLAGS = packed struct(UCHAR) {
        NTFS: bool = false,
        DOS: bool = false,
        Reserved2: u5 = 0,
        UNSPECIFIED: bool = false,
    };

    pub const NOTIFY = struct {
        pub const CHANGE = packed struct(ULONG) {
            FILE_NAME: bool = false,
            DIR_NAME: bool = false,
            ATTRIBUTES: bool = false,
            SIZE: bool = false,
            LAST_WRITE: bool = false,
            LAST_ACCESS: bool = false,
            CREATION: bool = false,
            EA: bool = false,
            SECURITY: bool = false,
            STREAM_NAME: bool = false,
            STREAM_SIZE: bool = false,
            STREAM_WRITE: bool = false,
            Reserved12: u20 = 0,
        };

        pub const INFORMATION = extern struct {
            NextEntryOffset: ULONG,
            Action: ULONG,
            FileNameLength: ULONG,
            FileName: [0]WCHAR,

            pub fn fileName(info: *INFORMATION) []WCHAR {
                const ptr: [*]WCHAR = @ptrCast(&info.FileName);
                return ptr[0..@divExact(info.FileNameLength, @sizeOf(WCHAR))];
            }
        };

        pub const EXTENDED_INFORMATION = extern struct {
            NextEntryOffset: ULONG,
            Action: ULONG,
            CreationTime: LARGE_INTEGER,
            LastModificationTime: LARGE_INTEGER,
            LastChangeTime: LARGE_INTEGER,
            LastAccessTime: LARGE_INTEGER,
            AllocatedLength: LARGE_INTEGER,
            FileSize: LARGE_INTEGER,
            FileAttributes: ATTRIBUTE,
            u: extern union {
                ReparsePointTag: ULONG,
                EaSize: ULONG,
            },
            FileId: LARGE_INTEGER,
            ParentFileId: LARGE_INTEGER,
            FileNameLength: ULONG,
            FileName: [0]WCHAR,

            pub fn fileName(info: *INFORMATION) []WCHAR {
                const ptr: [*]WCHAR = @ptrCast(&info.FileName);
                return ptr[0..@divExact(info.FileNameLength, @sizeOf(WCHAR))];
            }
        };

        pub const FULL_INFORMATION = extern struct {
            NextEntryOffset: ULONG,
            Action: ULONG,
            CreationTime: LARGE_INTEGER,
            LastModificationTime: LARGE_INTEGER,
            LastChangeTime: LARGE_INTEGER,
            LastAccessTime: LARGE_INTEGER,
            AllocatedLength: LARGE_INTEGER,
            FileSize: LARGE_INTEGER,
            FileAttributes: ATTRIBUTE,
            u: extern union {
                ReparsePointTag: ULONG,
                EaSize: ULONG,
            },
            FileId: LARGE_INTEGER,
            ParentFileId: LARGE_INTEGER,
            FileNameLength: ULONG,
            FileNameFlags: NAME_FLAGS,
            FileName: [0]WCHAR,

            pub fn fileName(info: *INFORMATION) []WCHAR {
                const ptr: [*]WCHAR = @ptrCast(&info.FileName);
                return ptr[0..@divExact(info.FileNameLength, @sizeOf(WCHAR))];
            }
        };
    };

    pub const PIPE = struct {
        /// 定义 `NtCreateNamedPipeFile` 的 `NamedPipeType` 标志
        pub const TYPE = packed struct(ULONG) {
            TYPE: enum(u1) {
                BYTE_STREAM = 0b0,
                MESSAGE = 0b1,
            } = .BYTE_STREAM,
            REMOTE_CLIENTS: enum(u1) {
                ACCEPT = 0b0,
                REJECT = 0b1,
            } = .ACCEPT,
            Reserved2: u30 = 0,

            pub const VALID_MASK: TYPE = .{
                .TYPE = .MESSAGE,
                .REMOTE_CLIENTS = .REJECT,
            };
        };

        /// 定义 `NtCreateNamedPipeFile` 的 `CompletionMode` 标志
        pub const COMPLETION_MODE = packed struct(ULONG) {
            OPERATION: enum(u1) {
                QUEUE = 0b0,
                COMPLETE = 0b1,
            } = .QUEUE,
            Reserved1: u31 = 0,
        };

        /// 为 `NtCreateNamedPipeFile` 定义 `ReadMode` 标志。
        pub const READ_MODE = packed struct(ULONG) {
            MODE: enum(u1) {
                BYTE_STREAM = 0b0,
                MESSAGE = 0b1,
            },
            Reserved1: u31 = 0,
        };

        /// 定义 `NtQueryInformationFile` 的 `NamedPipeConfiguration` 标志
        pub const CONFIGURATION = enum(ULONG) {
            INBOUND = 0x00000000,
            OUTBOUND = 0x00000001,
            FULL_DUPLEX = 0x00000002,
        };

        /// 为 `NtQueryInformationFile` 定义 `NamedPipeState` 标志。
        pub const STATE = enum(ULONG) {
            DISCONNECTED = 0x00000001,
            LISTENING = 0x00000002,
            CONNECTED = 0x00000003,
            CLOSING = 0x00000004,
        };

        /// 为 `NtQueryInformationFile` 定义 `NamedPipeEnd` 标志。
        pub const END = enum(ULONG) {
            CLIENT = 0x00000000,
            SERVER = 0x00000001,
        };

        pub const INFORMATION = extern struct {
            ReadMode: READ_MODE,
            CompletionMode: COMPLETION_MODE,
        };

        pub const LOCAL_INFORMATION = extern struct {
            NamedPipeType: TYPE,
            NamedPipeConfiguration: CONFIGURATION,
            MaximumInstances: ULONG,
            CurrentInstances: ULONG,
            InboundQuota: ULONG,
            ReadDataAvailable: ULONG,
            OutboundQuota: ULONG,
            WriteQuotaAvailable: ULONG,
            NamedPipeState: STATE,
            NamedPipeEnd: END,
        };

        pub const REMOTE_INFORMATION = extern struct {
            CollectDataTime: LARGE_INTEGER,
            MaximumCollectionCount: ULONG,
        };

        pub const WAIT_FOR_BUFFER = extern struct {
            Timeout: LARGE_INTEGER,
            NameLength: ULONG,
            TimeoutSpecified: BOOLEAN,
            Name: [PATH_MAX_WIDE]WCHAR,

            pub const WAIT_FOREVER: LARGE_INTEGER = std.math.minInt(LARGE_INTEGER);

            pub fn init(opts: struct {
                Timeout: ?LARGE_INTEGER = null,
                Name: []const WCHAR,
            }) WAIT_FOR_BUFFER {
                var fpwfb: WAIT_FOR_BUFFER = .{
                    .Timeout = opts.Timeout orelse undefined,
                    .NameLength = @intCast(@sizeOf(WCHAR) * opts.Name.len),
                    .TimeoutSpecified = @intFromBool(opts.Timeout != null),
                    .Name = undefined,
                };
                @memcpy(fpwfb.Name[0..opts.Name.len], opts.Name);
                return fpwfb;
            }

            pub fn getName(fpwfb: *const WAIT_FOR_BUFFER) []const WCHAR {
                return fpwfb.Name[0..@divExact(fpwfb.NameLength, @sizeOf(WCHAR))];
            }

            pub fn toBuffer(fpwfb: *const WAIT_FOR_BUFFER) []const u8 {
                const start: [*]const u8 = @ptrCast(fpwfb);
                return start[0 .. @offsetOf(WAIT_FOR_BUFFER, "Name") + fpwfb.NameLength];
            }
        };
    };

    pub const ALL_INFORMATION = extern struct {
        BasicInformation: BASIC_INFORMATION,
        StandardInformation: STANDARD_INFORMATION,
        InternalInformation: INTERNAL_INFORMATION,
        EaInformation: EA_INFORMATION,
        AccessInformation: ACCESS_INFORMATION,
        PositionInformation: POSITION_INFORMATION,
        ModeInformation: MODE.INFORMATION,
        AlignmentInformation: ALIGNMENT_INFORMATION,
        NameInformation: NAME_INFORMATION,
    };

    pub const INTERNAL_INFORMATION = extern struct {
        IndexNumber: LARGE_INTEGER,
    };

    pub const EA_INFORMATION = extern struct {
        EaSize: ULONG,
    };

    pub const ACCESS_INFORMATION = extern struct {
        AccessFlags: ACCESS_MASK,
    };

    /// 没有将其拆分为 RENAME_INFORMATION 和 RENAME_INFORMATION_EX,因为
    /// 两者的唯一区别是 `Flags` 类型(_EX 之前为 BOOLEAN,_EX 中为 ULONG),
    /// 这不会影响结构布局;RootDirectory 的偏移量无论如何都相同。
    ///
    pub const RENAME_INFORMATION = extern struct {
        Flags: FLAGS,
        RootDirectory: ?HANDLE,
        FileNameLength: ULONG,
        FileName: [PATH_MAX_WIDE]WCHAR,

        pub fn init(opts: struct {
            Flags: FLAGS = .{},
            RootDirectory: ?HANDLE = null,
            FileName: []const WCHAR,
        }) RENAME_INFORMATION {
            var fri: RENAME_INFORMATION = .{
                .Flags = opts.Flags,
                .RootDirectory = opts.RootDirectory,
                .FileNameLength = @intCast(@sizeOf(WCHAR) * opts.FileName.len),
                .FileName = undefined,
            };
            @memcpy(fri.FileName[0..opts.FileName.len], opts.FileName);
            return fri;
        }

        pub const FLAGS = packed struct(ULONG) {
            REPLACE_IF_EXISTS: bool = false,
            POSIX_SEMANTICS: bool = false,
            SUPPRESS_PIN_STATE_INHERITANCE: bool = false,
            SUPPRESS_STORAGE_RESERVE_INHERITANCE: bool = false,
            AVAILABLE_SPACE: enum(u2) {
                NO_PRESERVE = 0b00,
                NO_INCREASE = 0b01,
                NO_DECREASE = 0b10,
                PRESERVE = 0b11,
            } = .NO_PRESERVE,
            IGNORE_READONLY_ATTRIBUTE: bool = false,
            RESIZE_SR: enum(u2) {
                NO_FORCE = 0b00,
                FORCE_TARGET = 0b01,
                FORCE_SOURCE = 0b10,
                FORCE = 0b11,
            } = .NO_FORCE,
            Reserved9: u23 = 0,
        };

        pub fn getFileName(ri: *const RENAME_INFORMATION) []const WCHAR {
            return ri.FileName[0..@divExact(ri.FileNameLength, @sizeOf(WCHAR))];
        }

        pub fn toBuffer(fri: *RENAME_INFORMATION) []u8 {
            const start: [*]u8 = @ptrCast(fri);
            // 文档所述结构体的 ABI 大小为 24 字节,使用更小的大小
            // 会触发 INFO_LENGTH_MISMATCH。因此必须确保大小至少为 24 字节;例如,
            // FileNameLength 为 1 时,理论上只需要 22 字节。
            const size = @max(24, @offsetOf(RENAME_INFORMATION, "FileName") + fri.FileNameLength);
            return start[0..size];
        }
    };

    // 参考:km/wdm.h

    pub const INFORMATION_CLASS = enum(c_int) {
        Directory = 1,
        FullDirectory = 2,
        BothDirectory = 3,
        Basic = 4,
        Standard = 5,
        Internal = 6,
        Ea = 7,
        Access = 8,
        Name = 9,
        Rename = 10,
        Link = 11,
        Names = 12,
        Disposition = 13,
        Position = 14,
        FullEa = 15,
        Mode = 16,
        Alignment = 17,
        All = 18,
        Allocation = 19,
        EndOfFile = 20,
        AlternateName = 21,
        Stream = 22,
        Pipe = 23,
        PipeLocal = 24,
        PipeRemote = 25,
        MailslotQuery = 26,
        MailslotSet = 27,
        Compression = 28,
        ObjectId = 29,
        Completion = 30,
        MoveCluster = 31,
        Quota = 32,
        ReparsePoint = 33,
        NetworkOpen = 34,
        AttributeTag = 35,
        Tracking = 36,
        IdBothDirectory = 37,
        IdFullDirectory = 38,
        ValidDataLength = 39,
        ShortName = 40,
        IoCompletionNotification = 41,
        IoStatusBlockRange = 42,
        IoPriorityHint = 43,
        SfioReserve = 44,
        SfioVolume = 45,
        HardLink = 46,
        ProcessIdsUsingFile = 47,
        NormalizedName = 48,
        NetworkPhysicalName = 49,
        IdGlobalTxDirectory = 50,
        IsRemoteDevice = 51,
        Unused = 52,
        NumaNode = 53,
        StandardLink = 54,
        RemoteProtocol = 55,
        RenameBypassAccessCheck = 56,
        LinkBypassAccessCheck = 57,
        VolumeName = 58,
        Id = 59,
        IdExtdDirectory = 60,
        ReplaceCompletion = 61,
        HardLinkFullId = 62,
        IdExtdBothDirectory = 63,
        DispositionEx = 64,
        RenameEx = 65,
        RenameExBypassAccessCheck = 66,
        DesiredStorageClass = 67,
        Stat = 68,
        MemoryPartition = 69,
        StatLx = 70,
        CaseSensitive = 71,
        LinkEx = 72,
        LinkExBypassAccessCheck = 73,
        StorageReserveId = 74,
        CaseSensitiveForceAccessCheck = 75,
        KnownFolder = 76,
        StatBasic = 77,
        Id64ExtdDirectory = 78,
        Id64ExtdBothDirectory = 79,
        IdAllExtdDirectory = 80,
        IdAllExtdBothDirectory = 81,
        StreamReservation = 82,
        MupProvider = 83,
        _,

        pub const Maximum: @typeInfo(@This()).@"enum".tag_type = 1 + @typeInfo(@This()).@"enum".field_names.len;
    };

    pub const BASIC_INFORMATION = extern struct {
        CreationTime: LARGE_INTEGER,
        LastAccessTime: LARGE_INTEGER,
        LastWriteTime: LARGE_INTEGER,
        ChangeTime: LARGE_INTEGER,
        FileAttributes: ATTRIBUTE,
    };

    pub const STANDARD_INFORMATION = extern struct {
        AllocationSize: LARGE_INTEGER,
        EndOfFile: LARGE_INTEGER,
        NumberOfLinks: ULONG,
        DeletePending: BOOLEAN,
        Directory: BOOLEAN,
    };

    pub const POSITION_INFORMATION = extern struct {
        CurrentByteOffset: LARGE_INTEGER,
    };

    pub const FULL_EA_INFORMATION = extern struct {
        NextEntryOffset: ULONG,
        Flags: UCHAR,
        EaNameLength: UCHAR,
        EaValueLength: USHORT,
        EaName: [0]CHAR,
    };

    pub const FS_DEVICE_INFORMATION = extern struct {
        DeviceType: DEVICE_TYPE,
        Characteristics: ULONG,
    };

    pub const USE_FILE_POINTER_POSITION = -2;

    // 参考:um/WinBase.h

    pub const ATTRIBUTE_TAG_INFO = extern struct {
        FileAttributes: DWORD,
        ReparseTag: IO_REPARSE_TAG,
    };

    // 参考:um/winnt.h

    pub const SHARE = packed struct(ULONG) {
        /// 其他线程可打开此文件进行读取访问。
        READ: bool = false,
        /// 其他线程可打开该文件以获取写入访问权限。
        WRITE: bool = false,
        /// 其他线程可打开该文件以获取删除访问权限。
        DELETE: bool = false,
        Reserved3: u29 = 0,

        pub const VALID_FLAGS: SHARE = .{
            .READ = true,
            .WRITE = true,
            .DELETE = true,
        };
    };

    pub const ATTRIBUTE = packed struct(ULONG) {
        /// 文件为只读。应用程序可以读取文件,但不能写入或删除。
        READONLY: bool = false,
        /// 此文件为隐藏文件。不要将其包含在普通目录列表中。
        HIDDEN: bool = false,
        /// 此文件是操作系统的一部分,或由操作系统独占使用。
        SYSTEM: bool = false,
        Reserved3: u1 = 0,
        DIRECTORY: bool = false,
        /// 应归档此文件。应用程序使用此属性标记待备份或移除的文件。
        ARCHIVE: bool = false,
        DEVICE: bool = false,
        /// 文件没有设置其他属性。此属性仅在单独使用时有效。
        NORMAL: bool = false,
        /// 文件正被用作临时存储。
        TEMPORARY: bool = false,
        SPARSE_FILE: bool = false,
        REPARSE_POINT: bool = false,
        COMPRESSED: bool = false,
        /// 文件数据无法立即取得。此属性表示文件数据已物理移动到脱机存储。
        /// 分层存储管理软件 Remote Storage 使用此属性。应用程序不应随意更改它。
        OFFLINE: bool = false,
        NOT_CONTENT_INDEXED: bool = false,
        /// 文件或目录已加密。对于文件,表示全部文件数据均已加密;对于目录,表示新创建的文件与子目录默认加密。更多信息参见“文件加密”。
        ///
        /// 若同时指定 `SYSTEM`,此标志无效。
        ///
        /// Windows 的 Home、Home Premium、Starter 或 ARM 版本不支持此标志。
        ///
        ENCRYPTED: bool = false,
        INTEGRITY_STREAM: bool = false,
        VIRTUAL: bool = false,
        NO_SCRUB_DATA: bool = false,
        EA_or_RECALL_ON_OPEN: bool = false,
        PINNED: bool = false,
        UNPINNED: bool = false,
        Reserved21: u1 = 0,
        RECALL_ON_DATA_ACCESS: bool = false,
        Reserved23: u6 = 0,
        STRICTLY_SEQUENTIAL: bool = false,
        Reserved30: u2 = 0,
    };

    // 参考:um/winternl.h

    /// 定义创建处置方式的取值
    pub const CREATE_DISPOSITION = enum(ULONG) {
        /// 若文件已存在,则用给定文件替换;若不存在,则创建给定文件。
        SUPERSEDE = 0x00000000,
        /// 若文件已存在,则打开它而不创建新文件。
        /// 若不存在,则使请求失败,不创建文件。
        OPEN = 0x00000001,
        /// 若文件已存在,则使请求失败,不创建也不打开指定文件。若不存在,则创建。
        ///
        CREATE = 0x00000002,
        /// 如果文件已存在,则打开;如果不存在,则创建给定文件。
        OPEN_IF = 0x00000003,
        /// 如果文件已存在,则打开并覆盖;如果不存在,则使请求失败。
        OVERWRITE = 0x00000004,
        /// 若文件已存在,则打开并覆盖它;若不存在,则创建给定文件。
        OVERWRITE_IF = 0x00000005,

        pub const MAXIMUM_DISPOSITION: CREATE_DISPOSITION = .OVERWRITE_IF;
    };

    /// 定义创建或打开选项的标志
    pub const MODE = packed struct(ULONG) {
        /// 正在创建或打开的文件是目录文件。使用此标志时,CreateDisposition 参数必须设为 `.CREATE`、`.FILE_OPEN` 或 `.OPEN_IF`。
        /// 此时,其他兼容的 CreateOptions 标志仅包括 `SYNCHRONOUS_IO`、`WRITE_THROUGH`、`OPEN_FOR_BACKUP_INTENT` 和 `OPEN_BY_FILE_ID`。
        ///
        ///
        ///
        DIRECTORY_FILE: bool = false,
        /// 写入数据的应用程序必须先实际将数据传输到文件中,
        /// 之后才能将请求的写入操作视为完成。
        /// 若设置 CreateOptions 标志 `NO_INTERMEDIATE_BUFFERING`,
        /// 则会自动设置此标志。
        WRITE_THROUGH: bool = false,
        /// 对文件的所有访问都是顺序访问。
        SEQUENTIAL_ONLY: bool = false,
        /// 文件不能被缓存在驱动内部
        /// 缓冲区中。此标志与 DesiredAccess 的
        /// `FILE_APPEND_DATA` 标志不兼容。
        NO_INTERMEDIATE_BUFFERING: bool = false,
        IO: enum(u2) {
            /// 对文件的所有操作均异步执行。
            ASYNCHRONOUS = 0b00,
            /// 对此文件的所有操作都同步执行。代表调用方
            /// 进行的任何等待都可能被警报
            /// 提前终止。此标志还使输入输出系统
            /// 维护文件位置上下文。若设置此标志,
            /// 还必须在 DesiredAccess 中设置 `SYNCHRONIZE` 标志。
            SYNCHRONOUS_ALERT = 0b01,
            /// 文件上的全部操作均同步执行。系统中用于同步 I/O 排队和完成的等待不可被警醒。
            /// 此标志还会使 I/O 系统维护文件位置上下文。
            /// 若设置此标志,还必须设置 DesiredAccess 的 `SYNCHRONIZE` 标志。
            ///
            ///
            SYNCHRONOUS_NONALERT = 0b10,
            _,

            pub const VALID_FLAGS: @This() = @fromBackingInt(@intCast(0b11));
        },
        /// 打开的文件不能是目录文件,否则此调用
        /// 失败。打开的文件对象可以表示数据文件、
        /// 逻辑设备、虚拟设备、物理设备或卷。
        NON_DIRECTORY_FILE: bool = false,
        /// 为此文件创建树连接,以通过
        /// 网络打开它。设备驱动和中间层驱动不使用此标志。
        CREATE_TREE_CONNECTION: bool = false,
        /// 若目标文件已被机会锁锁定,立即以替代成功码 `STATUS_OPLOCK_BREAK_IN_PROGRESS` 完成操作,而非阻塞调用者线程。
        /// 文件已被机会锁锁定表示另一个调用者已经访问该文件。
        /// 设备驱动和中间层驱动不使用此标志。
        ///
        ///
        COMPLETE_IF_OPLOCKED: bool = false,
        /// 若正在打开的已有文件的扩展属性表明,调用者必须理解扩展属性 EA 才能正确解释文件,则使请求失败,因为调用者不理解如何处理 EA。
        /// 此标志与设备驱动和中间层驱动无关。
        ///
        ///
        ///
        NO_EA_KNOWLEDGE: bool = false,
        OPEN_REMOTE_INSTANCE: bool = false,
        /// 文件可能被随机访问,因此文件系统驱动程序或系统不应对文件执行顺序预读。
        ///
        RANDOM_ACCESS: bool = false,
        /// 当该文件最后一个句柄传入 `NtClose` 时删除文件。
        /// 若设置此标志,则 DesiredAccess 参数中必须设置 `DELETE`。
        ///
        DELETE_ON_CLOSE: bool = false,
        /// `ObjectAttributes` 参数指定的文件名
        /// 包含文件的 8 字节文件引用编号。此编号
        /// 由具体文件系统分配,且为该文件系统所特有。
        /// 如果文件是重解析点,文件名还会包含
        /// 设备名称。注意,FAT 文件系统不支持此
        /// 标志。设备驱动程序及中间驱动程序不使用此标志。
        OPEN_BY_FILE_ID: bool = false,
        /// 文件以备份意图打开。因此,系统
        /// 应先检查特定访问权限并授予调用方
        /// 适当的文件访问权限,然后才根据文件的安全描述符检查 DesiredAccess
        /// 参数。设备驱动程序和中间驱动程序
        /// 不使用此标志。
        OPEN_FOR_BACKUP_INTENT: bool = false,
        /// 禁止从父目录继承 `FILE_ATTRIBUTE.COMPRESSED`。
        /// 这样可在标记为压缩的目录中
        /// 创建非压缩文件。
        NO_COMPRESSION: bool = false,
        /// 以单次原子操作打开文件并请求
        /// 该文件的机会锁。文件系统
        /// 在执行创建操作之前检查机会锁;如果
        /// 操作会破坏已有机会锁,则以 STATUS_CANNOT_BREAK_OPLOCK
        /// 返回码使创建失败。更多
        /// 信息见备注部分。
        ///
        /// Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows
        /// XP 不支持此标志。
        ///
        /// 以下文件系统支持此标志:NTFS、FAT
        /// 和 exFAT。
        OPEN_REQUIRING_OPLOCK: bool = false,
        Reserved17: u3 = 0,
        /// 此标志允许应用程序请求筛选型机会
        /// 锁,以防止其他应用程序遇到共享冲突。
        /// 如果已有打开的句柄,创建请求将
        /// 以 STATUS_OPLOCK_NOT_GRANTED 失败。更多信息请参见
        /// 备注部分。
        RESERVE_OPFILTER: bool = false,
        /// 打开带重解析点的文件,并绕过该文件的常规
        /// 重解析点处理。更多信息参见备注
        /// 部分。
        OPEN_REPARSE_POINT: bool = false,
        /// 指示执行脱机存储或
        /// 虚拟化的所有过滤器,不要因本次打开
        /// 而回迁文件内容。
        OPEN_NO_RECALL: bool = false,
        /// 此标志指示文件系统捕获与调用线程关联
        /// 的用户。之后使用返回句柄调用
        /// `FltQueryVolumeInformation` 或 `ZwQueryVolumeInformationFile` 时,
        /// 在计算调用方可用空闲空间时,将采用
        /// 捕获的用户身份,而不是
        /// 调用发生时的用户身份。这适用于以下
        /// FsInformationClass 值:`FileFsSizeInformation`、
        /// `FileFsFullSizeInformation` 和 `FileFsFullSizeInformationEx`。
        OPEN_FOR_FREE_SPACE_QUERY: bool = false,
        Reserved24: u8 = 0,

        pub const VALID_OPTION_FLAGS: MODE = .{
            .DIRECTORY_FILE = true,
            .WRITE_THROUGH = true,
            .SEQUENTIAL_ONLY = true,
            .NO_INTERMEDIATE_BUFFERING = true,
            .IO = .VALID_FLAGS,
            .NON_DIRECTORY_FILE = true,
            .CREATE_TREE_CONNECTION = true,
            .COMPLETE_IF_OPLOCKED = true,
            .NO_EA_KNOWLEDGE = true,
            .OPEN_REMOTE_INSTANCE = true,
            .RANDOM_ACCESS = true,
            .DELETE_ON_CLOSE = true,
            .OPEN_BY_FILE_ID = true,
            .OPEN_FOR_BACKUP_INTENT = true,
            .NO_COMPRESSION = true,
            .OPEN_REQUIRING_OPLOCK = true,
            .Reserved17 = 0b111,
            .RESERVE_OPFILTER = true,
            .OPEN_REPARSE_POINT = true,
            .OPEN_NO_RECALL = true,
            .OPEN_FOR_FREE_SPACE_QUERY = true,
        };

        pub const VALID_PIPE_OPTION_FLAGS: MODE = .{
            .WRITE_THROUGH = true,
            .IO = .VALID_FLAGS,
        };

        pub const VALID_MAILSLOT_OPTION_FLAGS: MODE = .{
            .WRITE_THROUGH = true,
            .IO = .VALID_FLAGS,
        };

        pub const VALID_SET_OPTION_FLAGS: MODE = .{
            .WRITE_THROUGH = true,
            .SEQUENTIAL_ONLY = true,
            .IO = .VALID_FLAGS,
        };

        // 参考:km/ntifs.h

        pub const INFORMATION = extern struct {
            /// 指定文件访问模式的一组标志。
            /// 这些标志是 `MODE` 的子集。
            Mode: MODE,
        };
    };
};

pub const DIRECTORY = struct {
    pub const NOTIFY_INFORMATION_CLASS = enum(c_int) {
        Notify = 1,
        NotifyExtended = 2,
        NotifyFull = 3,
        _,

        pub const Maximum: @typeInfo(@This()).@"enum".tag_type = 1 + @typeInfo(@This()).@"enum".field_names.len;
    };
};

pub const CONSOLE = struct {
    pub const USER_IO = struct {
        pub const INFO = struct {
            pub const CP = extern struct {
                /// GetCP:输出
                /// SetCP:输入
                CodePage: UINT,
                /// 输入
                Mode: MODE,

                pub const MODE = enum(BOOLEAN.Backing) {
                    Input,
                    Output,
                };
            };

            pub const WRITE = extern struct {
                /// 输出,以字节计
                Size: DWORD,
                /// 输入
                Mode: MODE,

                pub const MODE = enum(BOOLEAN.Backing) {
                    Character,
                    WideCharacter,
                };
            };

            pub const FILL = extern struct {
                /// 输入
                dwWriteCoord: COORD,
                /// 输入
                Tag: WITH.Tag,
                /// 输入
                With: WITH.Payload,
                /// 输入/输出,单位为字符
                nLength: DWORD,

                pub const WITH = union(enum(DWORD)) {
                    Character: CHAR = 1,
                    WideCharacter: WCHAR = 2,
                    Attribute: WORD = 3,

                    pub const Tag = @typeInfo(WITH).@"union".tag_type.?;
                    pub const Payload = PAYLOAD: {
                        const with_info = @typeInfo(WITH).@"union";
                        break :PAYLOAD @Union(.@"extern", null, with_info.field_names, with_info.field_types[0..], &@splat(.{}));
                    };
                };
            };

            /// 全部输出
            pub const SCREEN_BUFFER = extern struct {
                dwSize: COORD,
                dwCursorPosition: COORD,
                dwWindowPosition: COORD,
                wAttributes: WORD,
                dwWindowSize: COORD,
                dwMaximumWindowSize: COORD,
                wPopupAttributes: WORD,
                bFullscreenSupported: BOOL,
                ColorTable: [16]COLORREF,
            };

            pub const READ_OUTPUT_CHARACTER = extern struct {
                /// 输入
                dwReadCoord: COORD,
                Mode: MODE,
                /// 输出,以字符计
                nLength: DWORD,

                pub const MODE = enum(DWORD) {
                    Character = 1,
                    WideCharacter = 2,
                };
            };
        };

        pub fn GET_CP(mode: INFO.CP.MODE) Header.With(INFO.CP) {
            return .init(.GetCP, .{ .CodePage = undefined, .Mode = mode });
        }
        pub const GET_MODE: Header.With(DWORD) = .init(.GetMode, undefined);
        pub fn SET_MODE(mode: DWORD) Header.With(DWORD) {
            return .init(.SetMode, mode);
        }
        pub fn WRITE(mode: INFO.WRITE.MODE) Header.With(INFO.WRITE) {
            return .init(.Write, .{ .Size = undefined, .Mode = mode });
        }
        pub fn FILL(with: INFO.FILL.WITH, len: DWORD, coord: COORD) Header.With(INFO.FILL) {
            return .init(.Fill, .{
                .dwWriteCoord = coord,
                .Tag = with,
                .With = switch (with) {
                    inline else => |payload, tag| @unionInit(
                        INFO.FILL.WITH.Payload,
                        @tagName(tag),
                        payload,
                    ),
                },
                .nLength = len,
            });
        }
        pub fn SET_CP(mode: INFO.CP.MODE, cp: UINT) Header.With(INFO.CP) {
            return .init(.SetCP, .{ .CodePage = cp, .Mode = mode });
        }
        pub const GET_SCREEN_BUFFER_INFO: Header.With(INFO.SCREEN_BUFFER) =
            .init(.GetScreenBufferInfo, undefined);
        pub fn SET_CURSOR_POSITION(coord: COORD) Header.With(COORD) {
            return .init(.SetCursorPosition, coord);
        }
        pub fn SET_TEXT_ATTRIBUTE(attribute: WORD) Header.With(WORD) {
            return .init(.SetTextAttribute, attribute);
        }
        pub fn READ_OUTPUT_CHARACTER(
            coord: COORD,
            mode: INFO.READ_OUTPUT_CHARACTER.MODE,
        ) Header.With(INFO.READ_OUTPUT_CHARACTER) {
            return .init(.ReadOutputCharacter, .{
                .dwReadCoord = coord,
                .Mode = mode,
                .nLength = undefined,
            });
        }

        pub const InputBuffer = extern struct {
            Size: u32,
            Pointer: *const anyopaque,
        };

        pub const OutputBuffer = extern struct {
            Size: u32,
            Pointer: *anyopaque,
        };

        pub fn Request(comptime in_len: u32, comptime out_len: u32) type {
            return extern struct {
                Handle: ?HANDLE,
                InputBuffersLength: u32,
                OutputBuffersLength: u32,
                InputBuffers: [in_len]InputBuffer,
                OutputBuffers: [out_len]OutputBuffer,

                pub fn init(
                    handle: ?HANDLE,
                    in: [in_len]InputBuffer,
                    out: [out_len]OutputBuffer,
                ) @This() {
                    return .{
                        .Handle = handle,
                        .InputBuffersLength = in_len,
                        .OutputBuffersLength = out_len,
                        .InputBuffers = in,
                        .OutputBuffers = out,
                    };
                }
            };
        }

        pub const Header = extern struct {
            Operation: Operation,
            Size: u32,

            pub fn With(comptime Data: type) type {
                return extern struct {
                    Header: Header,
                    Data: Data,

                    pub fn init(operation: Operation, data: Data) @This() {
                        return .{
                            .Header = .{ .Operation = operation, .Size = @sizeOf(Data) },
                            .Data = data,
                        };
                    }

                    pub fn request(
                        with: *@This(),
                        file: ?Io.File,
                        comptime in_len: u32,
                        in: [in_len]InputBuffer,
                        comptime out_len: u32,
                        out: [out_len]OutputBuffer,
                    ) Request(1 + in_len, 1 + out_len) {
                        return .init(
                            if (file) |f| f.handle else null,
                            [1]InputBuffer{.{
                                .Size = @offsetOf(@This(), "Data") + @sizeOf(Data),
                                .Pointer = with,
                            }} ++ in,
                            [1]OutputBuffer{.{ .Size = @sizeOf(Data), .Pointer = &with.Data }} ++ out,
                        );
                    }

                    pub fn operate(with: *@This(), io: Io, file: ?Io.File) Io.Cancelable!NTSTATUS {
                        return (try io.operate(.{ .device_io_control = .{
                            .file = .{
                                .handle = peb().ProcessParameters.ConsoleHandle,
                                .flags = .{ .nonblocking = false },
                            },
                            .code = IOCTL.CONDRV.ISSUE_USER_IO,
                            .in = @ptrCast(&with.request(file, 0, .{}, 0, .{})),
                        } })).device_io_control.u.Status;
                    }
                };
            }
        };

        pub const Operation = enum(u32) {
            GetCP = 0x1000000,
            GetMode = 0x1000001,
            SetMode = 0x1000002,
            Read = 0x1000005,
            Write = 0x1000006,
            Fill = 0x2000000,
            SetCP = 0x2000004,
            GetScreenBufferInfo = 0x2000007,
            SetCursorPosition = 0x200000a,
            SetTextAttribute = 0x200000d,
            ReadOutputCharacter = 0x200000f,
            _,
        };
    };
};

pub const AFD = packed struct(ULONG) {
    NO_FAST_IO: bool = false,
    OVERLAPPED: bool = false,
    Reserved0: u30 = 0,

    pub const Mutability = enum { @"const", @"var" };
    pub fn WSABUF(comptime mutability: Mutability) type {
        return extern struct {
            len: ULONG,
            buf: switch (mutability) {
                .@"const" => [*]const u8,
                .@"var" => [*]u8,
            },
        };
    }
    pub const GUARANTEE = enum(c_int) {
        BestEffort,
        ControlledLoad,
        Predictive,
        GuaranteedDelay,
        Guaranteed,
        _,
    };
    pub const DEVICE_NAME: []const u16 = &.{ '\\', 'D', 'e', 'v', 'i', 'c', 'e', '\\', 'A', 'f', 'd' };
    pub const ENDPOINT_TYPE = packed struct(ULONG) {
        CONNECTIONLESS: bool = false,
        Reserved1: u3 = 0,
        MESSAGEMODE: bool = false,
        Reserved5: u3 = 0,
        RAW: bool = false,
        Reserved9: u22 = 0,
        REGISTERED_IO: bool = false,
    };
    pub const OPEN_PACKET = extern struct {
        EndpointType: ENDPOINT_TYPE,
        GroupID: LONG,
        AddressFamily: LONG,
        SocketType: LONG,
        Protocol: LONG,
        TransportDeviceNameLength: ULONG,
        TransportDeviceName: [1]WCHAR,

        pub const NAME = "AfdOpenPacketXX";

        pub const FULL_EA_INFORMATION = extern struct {
            Header: FILE.FULL_EA_INFORMATION = .{
                .NextEntryOffset = 0,
                .Flags = 0,
                .EaNameLength = NAME.len,
                .EaValueLength = @sizeOf(OPEN_PACKET),
                .EaName = .{},
            },
            Name: [NAME.len:0]u8 = NAME.*,
            Value: OPEN_PACKET,
        };
    };
    pub const BIND_INFO = extern struct {
        Mode: MODE,

        pub const MODE = enum(ULONG) {
            Unix = 0,
            Passive = 1,
            Active = 2,
            _,
        };
    };
    pub const LISTEN_INFO = extern struct {
        UseSAN: BOOLEAN,
        MaximumConnectionQueue: ULONG,
        UseDelayedAcceptance: BOOLEAN,
    };
    pub const LISTEN_RESPONSE_INFO = extern struct {
        Sequence: ULONG,
    };
    pub const ACCEPT_INFO = extern struct {
        UseSAN: BOOLEAN,
        Sequence: ULONG,
        AcceptHandle: HANDLE,
    };
    pub const SUPER_ACCEPT_INFO = extern struct {
        UseSAN: BOOLEAN,
        AcceptHandle: HANDLE,
        AcceptEndpoint: PVOID,
        AcceptFileObject: PVOID,
        ReceiveDataLength: ULONG,
        LocalAddressLength: ULONG,
        RemoteAddressLength: ULONG,
        ListenResponseInfo: LISTEN_RESPONSE_INFO,
    };
    pub const DEFER_ACCEPT_INFO = extern struct {
        Sequence: ULONG,
        Reject: BOOLEAN,
    };
    pub const PARTIAL_DISCONNECT_INFO = extern struct {
        DisconnectMode: MODE,
        Timeout: LARGE_INTEGER,

        pub const MODE = packed struct(ULONG) {
            SEND: bool = false,
            RECEIVE: bool = false,
            ABORTIVE: bool = false,
            UNCONNECT_DATAGRAM: bool = false,
            Reserved4: u28 = 0,
        };
    };
    pub const RECEIVE_INFORMATION = extern struct {
        BytesAvailable: ULONG,
        ExpeditedBytesAvailable: ULONG,
    };
    pub const HANDLE_INFO = extern struct {
        TdiAddressHandle: HANDLE,
        TdiConnectionHandle: HANDLE,
    };
    pub const INFORMATION = extern struct {
        InformationType: TYPE,
        Information: extern union {
            Boolean: BOOLEAN,
            Ulong: ULONG,
            LargeInteger: LARGE_INTEGER,
        },

        pub const TYPE = enum(ULONG) {
            INLINE_MODE = 0x01,
            NONBLOCKING_MODE = 0x02,
            MAX_SEND_SIZE = 0x03,
            SENDS_PENDING = 0x04,
            MAX_PATH_SEND_SIZE = 0x05,
            RECEIVE_WINDOW_SIZE = 0x06,
            SEND_WINDOW_SIZE = 0x07,
            CONNECT_TIME = 0x08,
            CIRCULAR_QUEUEING = 0x09,
            GROUP_ID_AND_TYPE = 0x0A,
            _,
        };
    };
    pub const TRANSMIT_FILE_INFO = extern struct {
        Offset: LARGE_INTEGER,
        WriteLength: LARGE_INTEGER,
        SendPacketLength: ULONG,
        FileHandle: HANDLE,
        Head: PVOID,
        HeadLength: ULONG,
        Tail: PVOID,
        TailLength: ULONG,
        Flags: FLAGS,

        pub const FLAGS = packed struct(ULONG) {
            DISCONNECT: bool = false,
            REUSE_SOCKET: bool = false,
            WRITE_BEHIND: bool = false,
            Reserved3: u25 = 0,
        };
    };
    pub const QUEUE_APC_INFO = extern struct {
        Thread: HANDLE,
        ApcRoutine: PVOID,
        ApcContext: PVOID,
        SystemArgument1: PVOID,
        SystemArgument2: PVOID,
    };
    pub const SEND_INFO = extern struct {
        BufferArray: [*]const WSABUF(.@"const"),
        BufferCount: ULONG,
        AfdFlags: AFD,
        TdiFlags: TDI.SEND,
    };
    pub const SEND_DATAGRAM_INFO = extern struct {
        BufferArray: [*]const WSABUF(.@"const"),
        BufferCount: ULONG,
        AfdFlags: AFD,
        TdiRequest: TDI.REQUEST.SEND_DATAGRAM,
        TdiConnInfo: TDI.CONNECTION.INFORMATION,
    };
    pub const RECV_INFO = extern struct {
        BufferArray: [*]const WSABUF(.@"var"),
        BufferCount: ULONG,
        AfdFlags: AFD,
        TdiFlags: TDI.RECEIVE,
    };
    pub const RECV_DATAGRAM_INFO = extern struct {
        BufferArray: [*]const WSABUF(.@"var"),
        BufferCount: ULONG,
        AfdFlags: AFD,
        TdiFlags: TDI.RECEIVE,
        Address: PVOID,
        AddressLength: *ULONG,
    };
    pub const SOCKOPT_INFO = extern struct {
        mode: Mode,
        level: i32,
        optname: u32,
        ding: u32 = 1,
        optval: *const anyopaque,
        optlen: usize,

        pub const Mode = enum(u32) { set = 1, get = 2, special = 3, _ };

        pub const UNIX_PATH = extern struct { Unknown0: usize = 0, Path: [PATH_MAX_WIDE:0]u16 };
    };
};

pub const TDI = struct {
    pub const STATUS = NTSTATUS;
    pub const CONNECTION = struct {
        pub const CONTEXT = PVOID;
        pub const INFORMATION = extern struct {
            /// 用户数据缓冲区长度
            UserDataLength: LONG,
            /// 指向用户数据缓冲区的指针
            UserData: PVOID,
            /// 后续缓冲区的长度
            OptionsLength: LONG,
            /// 指向含选项的缓冲区的指针
            Options: PVOID,
            /// 后续缓冲区的长度
            RemoteAddressLength: LONG,
            /// 包含远程地址的缓冲区
            RemoteAddress: PVOID,
        };
    };
    pub const ADDRESS = struct {
        pub const TYPE = enum(USHORT) {
            /// 未指定
            UNSPEC = 0,
            /// 主机本地(管道、门户,
            UNIX = 1,
            /// 网际互连:UDP、TCP 等。
            IP = 2,
            /// arpanet imp 地址
            IMPLINK = 3,
            /// PUP 协议,例如 BSP
            PUP = 4,
            /// MIT CHAOS 协议
            CHAOS = 5,
            /// XEROX NS 协议
            NS = 6,
            /// Netware IPX
            IPX = 6,
            /// NBS 协议
            NBS = 7,
            /// 欧洲计算机制造商
            ECMA = 8,
            /// datakit 协议
            DATAKIT = 9,
            /// CCITT 协议,如 X.25 等
            CCITT = 10,
            /// IBM SNA
            SNA = 11,
            /// DECnet
            DECnet = 12,
            /// 直接数据链路接口
            DLI = 13,
            /// LAT
            LAT = 14,
            /// NSC Hyperchannel
            HYLINK = 15,
            /// AppleTalk
            APPLETALK = 16,
            /// Netbios 地址
            NETBIOS = 17,
            @"8022" = 18,
            OSI_TSAP = 19,
            /// 用于 WzMail
            NETONE = 20,
            /// Banyan VINES IP
            VNS = 21,
            /// NETBIOS 地址扩展
            NETBIOS_EX = 22,
            /// IP 版本 6
            IP6 = 23,
            /// WCHAR Netbios 地址
            NETBIOS_UNICODE_EX = 24,
            _,
        };
        pub const IP = extern struct {
            sin_port: USHORT,
            in_addr: ULONG,
            sin_zero: [8]UCHAR,
        };
        pub const IP6 = extern struct {
            sin_port: USHORT,
            flowinfo: ULONG,
            addr: [8]USHORT,
            scope_id: ULONG,
        };
    };
    pub const REQUEST = extern struct {
        Handle: extern union {
            AddressHandle: HANDLE,
            ConnectionContext: CONNECTION.CONTEXT,
            ControlChannel: HANDLE,
        },
        RequestNotifyObject: PVOID,
        RequestContext: PVOID,
        TdiStatus: TDI.STATUS,

        pub const STATUS = extern struct {
            /// 请求完成状态
            Status: TDI.STATUS,
            /// 请求上下文
            RequestContext: PVOID,
            /// 请求中传输的字节数
            BytesTransferred: ULONG,
        };
        pub const ASSOCIATE = extern struct {
            Request: REQUEST,
            AddressHandle: HANDLE,
        };
        pub const CONNECT = extern struct {
            Request: REQUEST,
            RequestConnectionInformation: *CONNECTION.INFORMATION,
            ReturnConnectionInformation: *CONNECTION.INFORMATION,
            Timeout: LARGE_INTEGER,
        };
        pub const ACCEPT = extern struct {
            Request: REQUEST,
            RequestConnectionInformation: *CONNECTION.INFORMATION,
            ReturnConnectionInformation: *CONNECTION.INFORMATION,
        };
        pub const LISTEN = extern struct {
            Request: REQUEST,
            RequestConnectionInformation: *CONNECTION.INFORMATION,
            ReturnConnectionInformation: *CONNECTION.INFORMATION,
            ListenFlags: USHORT,
        };
        pub const DISCONNECT = extern struct {
            Request: REQUEST,
            Timeout: LARGE_INTEGER,
        };
        pub const SEND = extern struct {
            Request: REQUEST,
            SendFlags: USHORT,
        };
        pub const RECEIVE = extern struct {
            Request: REQUEST,
            ReceiveFlags: USHORT,
        };
        pub const SEND_DATAGRAM = extern struct {
            Request: REQUEST,
            SendDatagramInformation: *CONNECTION.INFORMATION,
        };
    };
    pub const RECEIVE = packed struct(ULONG) {
        Reserved0: u2 = 0,
        BROADCAST: bool = false,
        MULTICAST: bool = false,
        PARTIAL: bool = false,
        NORMAL: bool = false,
        EXPEDITED: bool = false,
        PEEK: bool = false,
        NO_RESPONSE_EXP: bool = false,
        COPY_LOOKAHEAD: bool = false,
        ENTIRE_MESSAGE: bool = false,
        AT_DISPATCH_LEVEL: bool = false,
        CONTROL_INFO: bool = false,
        FORCE_INDICATION: bool = false,
        NO_PUSH: bool = false,
        Reserved12: u17 = 0,
    };
    pub const SEND = packed struct(ULONG) {
        Reserved0: u5 = 0,
        EXPEDITED: bool = false,
        PARTIAL: bool = false,
        NO_RESPONSE_EXPECTED: bool = false,
        NON_BLOCKING: bool = false,
        AND_DISCONNECT: bool = false,
        Reserved10: u22 = 0,
    };
};

pub const NET = struct {
    pub const LUID = packed struct(ULONG64) { Reserved: u24 = 0, Index: u24, IfType: u16 };
    pub const IFINDEX = enum(ULONG) { _ };
};

pub const DNS = struct {
    pub const INTERFACE_SETTINGS = extern struct {
        Version: ULONG,
        Flags: ULONG64,
        Domain: PWSTR,
        NameServer: PWSTR,
        SearchList: PWSTR,
        RegistrationEnabled: ULONG,
        RegisterAdapterName: ULONG,
        EnableLLMNR: ULONG,
        QueryAdapterName: ULONG,
        ProfileNameServer: PWSTR,
    };

    // ref: shared/windnsdef.h

    pub const ADDR_MAX_SOCKADDR_LENGTH = 32;

    pub const ADDR = extern struct {
        MaxSa: [ADDR_MAX_SOCKADDR_LENGTH]CHAR,
        DnsAddrUserDword: [8]DWORD,

        pub const ARRAY = extern struct {
            MaxCount: DWORD,
            AddrCount: DWORD,
            Tag: DWORD,
            Family: WORD,
            WordReserved: WORD,
            Flags: DWORD,
            MatchFlag: DWORD,
            Reserved1: DWORD,
            Reserved2: DWORD,
            AddrArray: [0]ADDR,
        };
    };

    pub const CUSTOM_SERVER = extern struct {
        ServerType: CUSTOM_SERVER.TYPE,
        Flags: FLAGS,
        Info: extern union {
            UDP: void,
            DOH: extern struct { Template: PWSTR },
            DOT: extern struct { Hostname: PWSTR },
        },
        MaxSa: [ADDR_MAX_SOCKADDR_LENGTH]CHAR,

        pub const TYPE = enum(DWORD) { UDP = 0x1, DOH = 0x2, DOT = 0x3, _ };
        pub const FLAGS = packed struct(ULONG64) {
            UDP_FALLBACK: bool = false,
            UPGRADE_FROM_WELL_KNOWN_SERVERS: bool = false,
            Reserved2: u62 = 0,
        };
    };

    // 参考:um/WinDNS.h

    pub const STATUS = Win32Error;

    pub const TYPE = enum(WORD) {
        A = 0x0001,
        NS = 0x0002,
        MD = 0x0003,
        MF = 0x0004,
        CNAME = 0x0005,
        SOA = 0x0006,
        MB = 0x0007,
        MG = 0x0008,
        MR = 0x0009,
        NULL = 0x000a,
        WKS = 0x000b,
        PTR = 0x000c,
        HINFO = 0x000d,
        MINFO = 0x000e,
        MX = 0x000f,
        TEXT = 0x0010,
        RP = 0x0011,
        AFSDB = 0x0012,
        X25 = 0x0013,
        ISDN = 0x0014,
        RT = 0x0015,
        NSAP = 0x0016,
        NSAPPTR = 0x0017,
        SIG = 0x0018,
        KEY = 0x0019,
        PX = 0x001a,
        GPOS = 0x001b,
        AAAA = 0x001c,
        LOC = 0x001d,
        NXT = 0x001e,
        EID = 0x001f,
        NIMLOC = 0x0020,
        SRV = 0x0021,
        ATMA = 0x0022,
        NAPTR = 0x0023,
        KX = 0x0024,
        CERT = 0x0025,
        A6 = 0x0026,
        DNAME = 0x0027,
        SINK = 0x0028,
        OPT = 0x0029,
        DS = 0x002B,
        RRSIG = 0x002E,
        NSEC = 0x002F,
        DNSKEY = 0x0030,
        DHCID = 0x0031,
        UINFO = 0x0064,
        UID = 0x0065,
        GID = 0x0066,
        UNSPEC = 0x0067,
        ADDRS = 0x00f8,
        TKEY = 0x00f9,
        TSIG = 0x00fa,
        IXFR = 0x00fb,
        AXFR = 0x00fc,
        MAILB = 0x00fd,
        MAILA = 0x00fe,
        ALL = 0x00ff,
        WINS = 0xff01,
        WINSR = 0xff02,
        TLSA = 0x0034,
        SVCB = 0x0040,
        HTTPS = 0x0041,
        pub const NBSTAT: TYPE = .WINSR;
        pub const ANY: TYPE = .ALL;
    };

    pub const QUERY = packed struct(ULONG64) {
        pub const STANDARD: QUERY = .{};
        ACCEPT_TRUNCATED_RESPONSE: bool = false,
        USE_TCP_ONLY: bool = false,
        NO_RECURSION: bool = false,
        BYPASS_CACHE: bool = false,
        NO_WIRE_QUERY: bool = false,
        NO_LOCAL_NAME: bool = false,
        NO_HOSTS_FILE: bool = false,
        NO_NETBT: bool = false,
        WIRE_ONLY: bool = false,
        RETURN_MESSAGE: bool = false,
        MULTICAST_ONLY: bool = false,
        NO_MULTICAST: bool = false,
        TREAT_AS_FQDN: bool = false,
        ADDRCONFIG: bool = false,
        DUAL_ADDR: bool = false,
        Reserved15: u2 = 0,
        MULTICAST_WAIT: bool = false,
        MULTICAST_VERIFY: bool = false,
        Reserved19: u1 = 0,
        DONT_RESET_TTL_VALUES: bool = false,
        DISABLE_IDN_ENCODING: bool = false,
        Reserved22: u1 = 0,
        APPEND_MULTILABEL: bool = false,
        Reserved24: u34 = 0,
        PARSE_ALL_RECORDS: bool = false,
        Reserved59: u5 = 0,

        pub const REQUEST = extern struct {
            Version: DWORD,
            QueryName: PCWSTR,
            QueryType: TYPE,
            QueryOptions: QUERY = .STANDARD,
            pDnsServerList: ?*ADDR.ARRAY = null,
            InterfaceIndex: ULONG = 0,
            pQueryCompletionCallback: ?*const COMPLETION_ROUTINE = null,
            pQueryContext: ?*anyopaque = null,

            pub const @"3" = extern struct {
                Base: REQUEST,
                IsNetworkQueryRequired: BOOL = .FALSE,
                RequiredNetworkIndex: DWORD = 0,
                cCustomServers: DWORD = 0,
                pCustomServers: ?*CUSTOM_SERVER = null,
            };
        };
        pub const RESULT = extern struct {
            Version: ULONG,
            QueryStatus: STATUS,
            QueryOptions: QUERY,
            pQueryRecords: ?*RECORD,
            Reserved: ?*anyopaque,
        };
        pub const CANCEL = extern struct {
            Reserved: [32]CHAR align(8),
        };
        pub const COMPLETION_ROUTINE = fn (
            pQueryContext: ?*anyopaque,
            pQueryResults: *RESULT,
        ) callconv(.winapi) void;
    };
    pub const FREE_TYPE = enum(c_int) { Flat = 0, RecordList, ParsedMessageFields };
    pub const RECORD = extern struct {
        pNext: ?*RECORD,
        pName: *anyopaque,
        wType: TYPE,
        wDataLength: WORD,
        Flags: FLAGS,
        dwTtl: DWORD,
        dwReserved: DWORD,
        Data: extern union { A: [4]u8, AAAA: [16]u8 },

        pub const FLAGS = packed struct(DWORD) {
            Section: SECTION,
            Delete: u1,
            CharSet: u2,
            Unused: u3,
            Reserved: u24,
        };
    };
    pub const SECTION = enum(u2) { Question, Answer, Authority, Additional };
};

// 参考:km/ntddk.h

pub const SYSTEM = struct {
    pub const INFORMATION_CLASS = enum(c_int) {
        Basic = 0,
        Performance = 2,
        TimeOfDay = 3,
        Process = 5,
        ProcessorPerformance = 8,
        Interrupt = 23,
        Exception = 33,
        RegistryQuota = 37,
        Lookaside = 45,
        CodeIntegrity = 103,
        Policy = 134,
        _,
    };

    pub const BASIC_INFORMATION = extern struct {
        Reserved: ULONG,
        TimerResolution: ULONG,
        PageSize: ULONG,
        NumberOfPhysicalPages: ULONG,
        LowestPhysicalPageNumber: ULONG,
        HighestPhysicalPageNumber: ULONG,
        AllocationGranularity: ULONG,
        MinimumUserModeAddress: ULONG_PTR,
        MaximumUserModeAddress: ULONG_PTR,
        ActiveProcessorsAffinityMask: KAFFINITY,
        NumberOfProcessors: UCHAR,
    };
};

pub const PROCESS = struct {
    pub const INFORMATION = extern struct {
        hProcess: HANDLE,
        hThread: HANDLE,
        dwProcessId: DWORD,
        dwThreadId: DWORD,
    };

    pub const INFOCLASS = enum(c_int) {
        BasicInformation = 0,
        QuotaLimits = 1,
        IoCounters = 2,
        VmCounters = 3,
        Times = 4,
        BasePriority = 5,
        RaisePriority = 6,
        DebugPort = 7,
        ExceptionPort = 8,
        AccessToken = 9,
        LdtInformation = 10,
        LdtSize = 11,
        DefaultHardErrorMode = 12,
        IoPortHandlers = 13,
        PooledUsageAndLimits = 14,
        WorkingSetWatch = 15,
        UserModeIOPL = 16,
        EnableAlignmentFaultFixup = 17,
        PriorityClass = 18,
        Wx86Information = 19,
        HandleCount = 20,
        AffinityMask = 21,
        PriorityBoost = 22,
        DeviceMap = 23,
        SessionInformation = 24,
        ForegroundInformation = 25,
        Wow64Information = 26,
        ImageFileName = 27,
        LUIDDeviceMapsEnabled = 28,
        BreakOnTermination = 29,
        DebugObjectHandle = 30,
        DebugFlags = 31,
        HandleTracing = 32,
        IoPriority = 33,
        ExecuteFlags = 34,
        TlsInformation = 35,
        Cookie = 36,
        ImageInformation = 37,
        CycleTime = 38,
        PagePriority = 39,
        InstrumentationCallback = 40,
        ThreadStackAllocation = 41,
        WorkingSetWatchEx = 42,
        ImageFileNameWin32 = 43,
        ImageFileMapping = 44,
        AffinityUpdateMode = 45,
        MemoryAllocationMode = 46,
        GroupInformation = 47,
        TokenVirtualizationEnabled = 48,
        OwnerInformation = 49,
        WindowInformation = 50,
        HandleInformation = 51,
        MitigationPolicy = 52,
        DynamicFunctionTableInformation = 53,
        HandleCheckingMode = 54,
        KeepAliveCount = 55,
        RevokeFileHandles = 56,
        WorkingSetControl = 57,
        HandleTable = 58,
        CheckStackExtentsMode = 59,
        CommandLineInformation = 60,
        ProtectionInformation = 61,
        MemoryExhaustion = 62,
        FaultInformation = 63,
        TelemetryIdInformation = 64,
        CommitReleaseInformation = 65,
        Reserved1Information = 66,
        Reserved2Information = 67,
        SubsystemProcess = 68,
        InPrivate = 70,
        RaiseUMExceptionOnInvalidHandleClose = 71,
        SubsystemInformation = 75,
        Win32kSyscallFilterInformation = 79,
        EnergyTrackingState = 82,
        NetworkIoCounters = 114,
        _,

        pub const Max: @typeInfo(@This()).@"enum".tag_type = 117;
    };

    pub const BASIC_INFORMATION = extern struct {
        ExitStatus: NTSTATUS,
        PebBaseAddress: *PEB,
        AffinityMask: ULONG_PTR,
        BasePriority: KPRIORITY,
        UniqueProcessId: ULONG_PTR,
        InheritedFromUniqueProcessId: ULONG_PTR,
    };

    pub const VM_COUNTERS = extern struct {
        PeakVirtualSize: SIZE_T,
        VirtualSize: SIZE_T,
        PageFaultCount: ULONG,
        PeakWorkingSetSize: SIZE_T,
        WorkingSetSize: SIZE_T,
        QuotaPeakPagedPoolUsage: SIZE_T,
        QuotaPagedPoolUsage: SIZE_T,
        QuotaPeakNonPagedPoolUsage: SIZE_T,
        QuotaNonPagedPoolUsage: SIZE_T,
        PagefileUsage: SIZE_T,
        PeakPagefileUsage: SIZE_T,
    };
};

pub const THREAD = struct {
    pub const INFOCLASS = enum(c_int) {
        BasicInformation = 0,
        Times = 1,
        Priority = 2,
        BasePriority = 3,
        AffinityMask = 4,
        ImpersonationToken = 5,
        DescriptorTableEntry = 6,
        EnableAlignmentFaultFixup = 7,
        EventPair_Reusable = 8,
        QuerySetWin32StartAddress = 9,
        ZeroTlsCell = 10,
        PerformanceCount = 11,
        AmILastThread = 12,
        IdealProcessor = 13,
        PriorityBoost = 14,
        SetTlsArrayAddress = 15,
        IsIoPending = 16,
        // 从此处起为 Windows 2000+
        HideFromDebugger = 17,
        // 从此处开始适用于 Windows XP 及更高版本
        BreakOnTermination = 18,
        SwitchLegacyState = 19,
        IsTerminated = 20,
        // 从此处开始适用于 Windows Vista 及更高版本
        LastSystemCall = 21,
        IoPriority = 22,
        CycleTime = 23,
        PagePriority = 24,
        ActualBasePriority = 25,
        TebInformation = 26,
        CSwitchMon = 27,
        // 从此处开始适用于 Windows 7 及更高版本
        CSwitchPmu = 28,
        Wow64Context = 29,
        GroupInformation = 30,
        UmsInformation = 31,
        CounterProfiling = 32,
        IdealProcessorEx = 33,
        // 从此处起为 Windows 8+
        CpuAccountingInformation = 34,
        // 从此处开始适用于 Windows 8.1 及更高版本
        SuspendCount = 35,
        // 从此处起为 Windows 10+
        HeterogeneousCpuPolicy = 36,
        ContainerId = 37,
        NameInformation = 38,
        SelectedCpuSets = 39,
        SystemThreadInformation = 40,
        ActualGroupAffinity = 41,
        DynamicCodePolicyInfo = 42,
        SubsystemInformation = 45,
        _,

        pub const Max: @typeInfo(@This()).@"enum".tag_type = 60;
    };

    pub const BASIC_INFORMATION = extern struct {
        ExitStatus: NTSTATUS,
        TebBaseAddress: PVOID,
        ClientId: CLIENT_ID,
        AffinityMask: KAFFINITY,
        Priority: KPRIORITY,
        BasePriority: KPRIORITY,
    };

    pub const CREATE_FLAGS = packed struct(ULONG) {
        CREATE_SUSPENDED: bool = false,
        SKIP_THREAD_ATTACH: bool = false,
        HIDE_FROM_DEBUGGER: bool = false,
        LOADER_WORKER: bool = false,
        SKIP_LOADER_INIT: bool = false,
        BYPASS_PROCESS_FREEZE: bool = false,
        Reserved6: u26 = 0,

        pub const NONE: CREATE_FLAGS = .{};
    };

    pub const StackSize = enum(SIZE_T) {
        /// 可执行文件头部指定的默认大小
        default = 0,
        _,
    };
};

// 参考:km/ntifs.h

pub const HEAP = opaque {
    pub const FLAGS = packed struct(u8) {
        /// 堆函数访问此堆时,不进行串行化访问控制。此选项适用于所有后续堆函数调用,也可仅在单次堆函数调用时指定。
        ///
        /// 使用此选项创建的堆无法启用低碎片堆 LFH。
        ///
        /// 使用此选项创建的堆无法锁定。
        ///
        ///
        NO_SERIALIZE: bool = false,
        /// 指定堆可增长。若 `HeapBase` 为 `NULL`,则必须指定。
        GROWABLE: bool = false,
        /// 调用 `HeapAlloc` 和 `HeapReAlloc` 失败时,例如内存不足,
        /// 系统会引发异常,而非返回 `NULL`。
        ///
        /// 为确保全部分配函数调用都会生成异常,应指定
        /// `GENERATE_EXCEPTIONS` 于 `HeapCreate` 调用。此时无需
        /// 再在各分配函数调用中额外指定 `GENERATE_EXCEPTIONS`。
        GENERATE_EXCEPTIONS: bool = false,
        /// 分配的内存将初始化为零。
        /// 否则,内存不会初始化为零。
        ZERO_MEMORY: bool = false,
        REALLOC_IN_PLACE_ONLY: bool = false,
        TAIL_CHECKING_ENABLED: bool = false,
        FREE_CHECKING_ENABLED: bool = false,
        DISABLE_COALESCE_ON_FREE: bool = false,

        pub const CLASS = enum(u4) {
            /// 进程堆
            PROCESS,
            /// 私有堆
            PRIVATE,
            /// 内核堆
            KERNEL,
            /// GDI 堆
            GDI,
            /// 用户堆
            USER,
            /// 控制台堆
            CONSOLE,
            /// 用户桌面堆
            USER_DESKTOP,
            /// Csrss 共享堆
            CSRSS_SHARED,
            /// Csr 端口堆
            CSR_PORT,
            _,

            pub const MASK: CLASS = @fromBackingInt(@intCast(maxInt(@typeInfo(CLASS).@"enum".tag_type)));
        };

        pub const CREATE = packed struct(ULONG) {
            COMMON: FLAGS = .{},
            SEGMENT_HEAP: bool = false,
            /// 仅适用于段堆。应用指针混淆,通常
            /// 过度且无必要,但对 win32k 中某些不安全的
            /// 堆是必需的。
            ///
            /// 指定 HEAP_CREATE_HARDENED 会阻止堆使用锁,
            /// 因为锁变量可能在堆元数据中暴露指针。
            /// 因此,调用方负责同步对强化堆的访问。
            HARDENED: bool = false,
            Reserved10: u2 = 0,
            CLASS: CLASS = @fromBackingInt(@intCast(0)),
            /// 创建按 16 字节对齐的堆(已废弃)
            ALIGN_16: bool = false,
            /// 已启用创建堆调用跟踪(已过时)
            ENABLE_TRACING: bool = false,
            /// 创建带可执行页的堆。
            ///
            /// 若硬件强制执行数据执行保护,从此堆分配的全部内存块仍允许执行代码。需要从堆执行代码的应用程序应使用此堆标志。
            /// 若未指定 `ENABLE_EXECUTE`,应用程序又尝试从受保护页执行代码,则会收到状态码为 `STATUS_ACCESS_VIOLATION` 的异常。
            ///
            ///
            ///
            ENABLE_EXECUTE: bool = false,
            Reserved19: u13 = 0,

            pub const VALID_MASK: CREATE = .{
                .COMMON = .{
                    .NO_SERIALIZE = true,
                    .GROWABLE = true,
                    .GENERATE_EXCEPTIONS = true,
                    .ZERO_MEMORY = true,
                    .REALLOC_IN_PLACE_ONLY = true,
                    .TAIL_CHECKING_ENABLED = true,
                    .FREE_CHECKING_ENABLED = true,
                    .DISABLE_COALESCE_ON_FREE = true,
                },
                .CLASS = .MASK,
                .ALIGN_16 = true,
                .ENABLE_TRACING = true,
                .ENABLE_EXECUTE = true,
                .SEGMENT_HEAP = true,
                .HARDENED = true,
            };
        };

        pub const ALLOCATION = packed struct(ULONG) {
            COMMON: FLAGS = .{},
            SETTABLE_USER: packed struct(u4) {
                VALUE: u1 = 0,
                FLAGS: packed struct(u3) {
                    FLAG1: bool = false,
                    FLAG2: bool = false,
                    FLAG3: bool = false,
                } = .{},
            } = .{},
            CLASS: CLASS = @fromBackingInt(@intCast(0)),
            Reserved16: u2 = 0,
            TAG: u12 = 0,
            Reserved30: u2 = 0,
        };
    };

    pub const RTL_PARAMETERS = extern struct {
        Length: ULONG,
        SegmentReserve: SIZE_T,
        SegmentCommit: SIZE_T,
        DeCommitFreeBlockThreshold: SIZE_T,
        DeCommitTotalFreeThreshold: SIZE_T,
        MaximumAllocationSize: SIZE_T,
        VirtualMemoryThreshold: SIZE_T,
        InitialCommit: SIZE_T,
        InitialReserve: SIZE_T,
        CommitRoutine: *const COMMIT_ROUTINE,
        Reserved: [2]SIZE_T = @splat(0),

        pub const COMMIT_ROUTINE = fn (
            Base: PVOID,
            CommitAddress: *PVOID,
            CommitSize: *SIZE_T,
        ) callconv(.winapi) NTSTATUS;

        pub const SEGMENT = extern struct {
            Version: VERSION,
            Size: USHORT,
            Flags: FLG,
            MemorySource: MEMORY_SOURCE,
            Reserved: [4]SIZE_T,

            pub const VERSION = enum(USHORT) {
                CURRENT = 3,
                _,
            };

            pub const FLG = packed struct(ULONG) {
                USE_PAGE_HEAP: bool = false,
                NO_LFH: bool = false,
                Reserved2: u30 = 0,

                pub const VALID_FLAGS: FLG = .{
                    .USE_PAGE_HEAP = true,
                    .NO_LFH = true,
                };
            };

            pub const MEMORY_SOURCE = extern struct {
                Flags: ULONG,
                MemoryTypeMask: TYPE,
                NumaNode: ULONG,
                u: extern union {
                    PartitionHandle: HANDLE,
                    Callbacks: *const VA_CALLBACKS,
                },
                Reserved: [2]SIZE_T = @splat(0),

                pub const TYPE = enum(ULONG) {
                    Paged,
                    NonPaged,
                    @"64KPage",
                    LargePage,
                    HugePage,
                    Custom,
                    _,

                    pub const Max: @typeInfo(@This()).@"enum".tag_type = @typeInfo(@This()).@"enum".field_names.len;
                };

                pub const VA_CALLBACKS = extern struct {
                    CallbackContext: HANDLE,
                    AllocateVirtualMemory: *const ALLOCATE_VIRTUAL_MEMORY_EX_CALLBACK,
                    FreeVirtualMemory: *const FREE_VIRTUAL_MEMORY_EX_CALLBACK,
                    QueryVirtualMemory: *const QUERY_VIRTUAL_MEMORY_CALLBACK,

                    pub const ALLOCATE_VIRTUAL_MEMORY_EX_CALLBACK = fn (
                        CallbackContext: HANDLE,
                        BaseAddress: *PVOID,
                        RegionSize: *SIZE_T,
                        AllocationType: ULONG,
                        PageProtection: ULONG,
                        ExtendedParameters: ?[*]MEM.EXTENDED_PARAMETER,
                        ExtendedParameterCount: ULONG,
                    ) callconv(.c) NTSTATUS;

                    pub const FREE_VIRTUAL_MEMORY_EX_CALLBACK = fn (
                        CallbackContext: HANDLE,
                        ProcessHandle: HANDLE,
                        BaseAddress: *PVOID,
                        RegionSize: *SIZE_T,
                        FreeType: ULONG,
                    ) callconv(.c) NTSTATUS;

                    pub const QUERY_VIRTUAL_MEMORY_CALLBACK = fn (
                        CallbackContext: HANDLE,
                        ProcessHandle: HANDLE,
                        BaseAddress: *PVOID,
                        MemoryInformationClass: MEMORY_INFO_CLASS,
                        MemoryInformation: PVOID,
                        MemoryInformationLength: SIZE_T,
                        ReturnLength: ?*SIZE_T,
                    ) callconv(.c) NTSTATUS;

                    pub const MEMORY_INFO_CLASS = enum(c_int) {
                        Basic,
                        _,
                    };
                };
            };
        };
    };
};

pub const CTL_CODE = packed struct(ULONG) {
    Method: METHOD,
    Function: u12,
    Access: FILE_ACCESS,
    DeviceType: FILE_DEVICE,

    pub const METHOD = enum(u2) {
        BUFFERED = 0,
        IN_DIRECT = 1,
        OUT_DIRECT = 2,
        NEITHER = 3,
    };

    pub const FILE_ACCESS = packed struct(u2) {
        READ: bool = false,
        WRITE: bool = false,

        pub const ANY: FILE_ACCESS = .{ .READ = false, .WRITE = false };
        pub const SPECIAL = ANY;
    };

    pub const FILE_DEVICE = enum(u16) {
        BEEP = 0x00000001,
        CD_ROM = 0x00000002,
        CD_ROM_FILE_SYSTEM = 0x00000003,
        CONTROLLER = 0x00000004,
        DATALINK = 0x00000005,
        DFS = 0x00000006,
        DISK = 0x00000007,
        DISK_FILE_SYSTEM = 0x00000008,
        FILE_SYSTEM = 0x00000009,
        INPORT_PORT = 0x0000000a,
        KEYBOARD = 0x0000000b,
        MAILSLOT = 0x0000000c,
        MIDI_IN = 0x0000000d,
        MIDI_OUT = 0x0000000e,
        MOUSE = 0x0000000f,
        MULTI_UNC_PROVIDER = 0x00000010,
        NAMED_PIPE = 0x00000011,
        NETWORK = 0x00000012,
        NETWORK_BROWSER = 0x00000013,
        NETWORK_FILE_SYSTEM = 0x00000014,
        NULL = 0x00000015,
        PARALLEL_PORT = 0x00000016,
        PHYSICAL_NETCARD = 0x00000017,
        PRINTER = 0x00000018,
        SCANNER = 0x00000019,
        SERIAL_MOUSE_PORT = 0x0000001a,
        SERIAL_PORT = 0x0000001b,
        SCREEN = 0x0000001c,
        SOUND = 0x0000001d,
        STREAMS = 0x0000001e,
        TAPE = 0x0000001f,
        TAPE_FILE_SYSTEM = 0x00000020,
        TRANSPORT = 0x00000021,
        UNKNOWN = 0x00000022,
        VIDEO = 0x00000023,
        VIRTUAL_DISK = 0x00000024,
        WAVE_IN = 0x00000025,
        WAVE_OUT = 0x00000026,
        @"8042_PORT" = 0x00000027,
        NETWORK_REDIRECTOR = 0x00000028,
        BATTERY = 0x00000029,
        BUS_EXTENDER = 0x0000002a,
        MODEM = 0x0000002b,
        VDM = 0x0000002c,
        MASS_STORAGE = 0x0000002d,
        SMB = 0x0000002e,
        KS = 0x0000002f,
        CHANGER = 0x00000030,
        SMARTCARD = 0x00000031,
        ACPI = 0x00000032,
        DVD = 0x00000033,
        FULLSCREEN_VIDEO = 0x00000034,
        DFS_FILE_SYSTEM = 0x00000035,
        DFS_VOLUME = 0x00000036,
        SERENUM = 0x00000037,
        TERMSRV = 0x00000038,
        KSEC = 0x00000039,
        FIPS = 0x0000003A,
        INFINIBAND = 0x0000003B,
        VMBUS = 0x0000003E,
        CRYPT_PROVIDER = 0x0000003F,
        WPD = 0x00000040,
        BLUETOOTH = 0x00000041,
        MT_COMPOSITE = 0x00000042,
        MT_TRANSPORT = 0x00000043,
        BIOMETRIC = 0x00000044,
        PMI = 0x00000045,
        EHSTOR = 0x00000046,
        DEVAPI = 0x00000047,
        GPIO = 0x00000048,
        USBEX = 0x00000049,
        CONSOLE = 0x00000050,
        NFP = 0x00000051,
        SYSENV = 0x00000052,
        VIRTUAL_BLOCK = 0x00000053,
        POINT_OF_SERVICE = 0x00000054,
        STORAGE_REPLICATION = 0x00000055,
        TRUST_ENV = 0x00000056,
        UCM = 0x00000057,
        UCMTCPCI = 0x00000058,
        PERSISTENT_MEMORY = 0x00000059,
        NVDIMM = 0x0000005a,
        HOLOGRAPHIC = 0x0000005b,
        SDFXHCI = 0x0000005c,
        UCMUCSI = 0x0000005d,
        PRM = 0x0000005e,
        EVENT_COLLECTOR = 0x0000005f,
        USB4 = 0x00000060,
        SOUNDWIRE = 0x00000061,

        MOUNTMGRCONTROLTYPE = 'm',

        _,
    };

    pub const SET_REPARSE_POINT: CTL_CODE = .{ .DeviceType = .FILE_SYSTEM, .Function = 41, .Method = .BUFFERED, .Access = .SPECIAL };
    pub const GET_REPARSE_POINT: CTL_CODE = .{ .DeviceType = .FILE_SYSTEM, .Function = 42, .Method = .BUFFERED, .Access = .ANY };

    pub const PIPE = struct {
        pub const ASSIGN_EVENT: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 0, .Method = .BUFFERED, .Access = .ANY };
        pub const DISCONNECT: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 1, .Method = .BUFFERED, .Access = .ANY };
        pub const LISTEN: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 2, .Method = .BUFFERED, .Access = .ANY };
        pub const PEEK: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 3, .Method = .BUFFERED, .Access = .{ .READ = true } };
        pub const QUERY_EVENT: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 4, .Method = .BUFFERED, .Access = .ANY };
        pub const TRANSCEIVE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 5, .Method = .NEITHER, .Access = .{ .READ = true, .WRITE = true } };
        pub const WAIT: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 6, .Method = .BUFFERED, .Access = .ANY };
        pub const IMPERSONATE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 7, .Method = .BUFFERED, .Access = .ANY };
        pub const SET_CLIENT_PROCESS: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 8, .Method = .BUFFERED, .Access = .ANY };
        pub const QUERY_CLIENT_PROCESS: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 9, .Method = .BUFFERED, .Access = .ANY };
        pub const GET_PIPE_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 10, .Method = .BUFFERED, .Access = .ANY };
        pub const SET_PIPE_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 11, .Method = .BUFFERED, .Access = .ANY };
        pub const GET_CONNECTION_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 12, .Method = .BUFFERED, .Access = .ANY };
        pub const SET_CONNECTION_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 13, .Method = .BUFFERED, .Access = .ANY };
        pub const GET_HANDLE_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 14, .Method = .BUFFERED, .Access = .ANY };
        pub const SET_HANDLE_ATTRIBUTE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 15, .Method = .BUFFERED, .Access = .ANY };
        pub const FLUSH: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 16, .Method = .BUFFERED, .Access = .{ .WRITE = true } };

        pub const INTERNAL_READ: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 2045, .Method = .BUFFERED, .Access = .{ .READ = true } };
        pub const INTERNAL_WRITE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 2046, .Method = .BUFFERED, .Access = .{ .WRITE = true } };
        pub const INTERNAL_TRANSCEIVE: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 2047, .Method = .NEITHER, .Access = .{ .READ = true, .WRITE = true } };
        pub const INTERNAL_READ_OVFLOW: CTL_CODE = .{ .DeviceType = .NAMED_PIPE, .Function = 2048, .Method = .BUFFERED, .Access = .{ .READ = true } };
    };
};

pub const IOCTL = struct {
    pub const AFD = struct {
        const CONTROL_CODE = packed struct {
            Method: CTL_CODE.METHOD,
            Function: u10,
            DeviceType: CTL_CODE.FILE_DEVICE,
            Reserved28: u4 = 0,
        };
        pub const BIND: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 0, .Method = .NEITHER });
        pub const CONNECT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 1, .Method = .NEITHER });
        pub const START_LISTEN: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 2, .Method = .NEITHER });
        pub const WAIT_FOR_LISTEN: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 3, .Method = .BUFFERED });
        pub const ACCEPT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 4, .Method = .BUFFERED });
        pub const RECEIVE: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 5, .Method = .NEITHER });
        pub const RECEIVE_DATAGRAM: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 6, .Method = .NEITHER });
        pub const SEND: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 7, .Method = .NEITHER });
        pub const SEND_DATAGRAM: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 8, .Method = .NEITHER });
        pub const POLL: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 9, .Method = .BUFFERED });
        pub const PARTIAL_DISCONNECT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 10, .Method = .NEITHER });

        pub const GET_ADDRESS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 11, .Method = .NEITHER });
        pub const QUERY_RECEIVE_INFO: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 12, .Method = .NEITHER });
        pub const QUERY_HANDLES: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 13, .Method = .NEITHER });
        pub const SET_INFORMATION: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 14, .Method = .NEITHER });
        pub const GET_CONTEXT_LENGTH: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 15, .Method = .NEITHER });
        pub const GET_CONTEXT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 16, .Method = .NEITHER });
        pub const SET_CONTEXT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 17, .Method = .NEITHER });

        pub const SET_CONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 18, .Method = .BUFFERED });
        pub const SET_CONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 19, .Method = .BUFFERED });
        pub const SET_DISCONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 20, .Method = .BUFFERED });
        pub const SET_DISCONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 21, .Method = .BUFFERED });
        pub const GET_CONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 22, .Method = .BUFFERED });
        pub const GET_CONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 23, .Method = .BUFFERED });
        pub const GET_DISCONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 24, .Method = .BUFFERED });
        pub const GET_DISCONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 25, .Method = .BUFFERED });
        pub const SIZE_CONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 26, .Method = .BUFFERED });
        pub const SIZE_CONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 27, .Method = .BUFFERED });
        pub const SIZE_DISCONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 28, .Method = .BUFFERED });
        pub const SIZE_DISCONNECT_OPTIONS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 29, .Method = .BUFFERED });

        pub const GET_INFORMATION: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 30, .Method = .NEITHER });
        pub const TRANSMIT_FILE: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 31, .Method = .NEITHER });
        pub const SUPER_ACCEPT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 32, .Method = .NEITHER });

        pub const EVENT_SELECT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 33, .Method = .BUFFERED });
        pub const ENUM_NETWORK_EVENTS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 34, .Method = .BUFFERED });

        pub const DEFER_ACCEPT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 35, .Method = .BUFFERED });
        pub const WAIT_FOR_LISTEN_LIFO: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 36, .Method = .BUFFERED });
        pub const SET_QOS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 37, .Method = .BUFFERED });
        pub const GET_QOS: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 38, .Method = .BUFFERED });
        pub const NO_OPERATION: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 39, .Method = .NEITHER });
        pub const VALIDATE_GROUP: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 40, .Method = .BUFFERED });
        pub const GET_UNACCEPTED_CONNECT_DATA: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 41, .Method = .BUFFERED });

        pub const QUEUE_APC: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 42, .Method = .BUFFERED });

        pub const SOCKOPT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 47, .Method = .NEITHER });
        pub const SUPER_CONNECT: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 49, .Method = .NEITHER });
        pub const RECV_MSG: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 51, .Method = .NEITHER });
        pub const RIO: CTL_CODE = @bitCast(CONTROL_CODE{ .DeviceType = .NETWORK, .Function = 70, .Method = .NEITHER });
    };
    pub const CONDRV = struct {
        pub const READ_IO: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 1, .Method = .OUT_DIRECT, .Access = .ANY };
        pub const COMPLETE_IO: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 2, .Method = .NEITHER, .Access = .ANY };
        pub const READ_INPUT: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 3, .Method = .NEITHER, .Access = .ANY };
        pub const WRITE_OUTPUT: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 4, .Method = .NEITHER, .Access = .ANY };
        pub const ISSUE_USER_IO: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 5, .Method = .OUT_DIRECT, .Access = .ANY };
        pub const DISCONNECT_PIPE: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 6, .Method = .NEITHER, .Access = .ANY };
        pub const SET_SERVER_INFORMATION: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 7, .Method = .NEITHER, .Access = .ANY };
        pub const GET_SERVER_PID: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 8, .Method = .NEITHER, .Access = .ANY };
        pub const GET_DISPLAY_SIZE: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 9, .Method = .NEITHER, .Access = .ANY };
        pub const UPDATE_DISPLAY: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 10, .Method = .NEITHER, .Access = .ANY };
        pub const SET_CURSOR: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 11, .Method = .NEITHER, .Access = .ANY };
        pub const ALLOW_VIA_UIACCESS: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 12, .Method = .NEITHER, .Access = .ANY };
        pub const LAUNCH_SERVER: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 13, .Method = .NEITHER, .Access = .ANY };
        pub const GET_FONT_SIZE: CTL_CODE = .{ .DeviceType = .CONSOLE, .Function = 14, .Method = .NEITHER, .Access = .ANY };
    };
    pub const KSEC = struct {
        pub const GEN_RANDOM: CTL_CODE = .{ .DeviceType = .KSEC, .Function = 2, .Method = .BUFFERED, .Access = .ANY };
    };
    pub const MOUNTMGR = struct {
        pub const QUERY_POINTS: CTL_CODE = .{ .DeviceType = .MOUNTMGRCONTROLTYPE, .Function = 2, .Method = .BUFFERED, .Access = .ANY };
        pub const QUERY_DOS_VOLUME_PATH: CTL_CODE = .{ .DeviceType = .MOUNTMGRCONTROLTYPE, .Function = 12, .Method = .BUFFERED, .Access = .ANY };
    };
};

pub const MAXIMUM_REPARSE_DATA_BUFFER_SIZE: ULONG = 16 * 1024;

pub const IO_REPARSE_TAG = packed struct(ULONG) {
    Value: u12,
    Index: u4 = 0,
    ReservedBits: u12 = 0,
    /// 若为目录则可具有子项。
    IsDirectory: bool = false,
    /// 表示系统中的另一个命名实体。
    IsSurrogate: bool = false,
    /// 对于非 Microsoft 标签,必须为 `false`。
    IsReserved: bool = false,
    /// 归 Microsoft 所有。
    IsMicrosoft: bool = false,

    pub const RESERVED_INVALID: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsReserved = true, .Index = 0x8, .Value = 0x000 };
    pub const MOUNT_POINT: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x003 };
    pub const HSM: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsReserved = true, .Value = 0x004 };
    pub const DRIVE_EXTENDER: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x005 };
    pub const HSM2: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x006 };
    pub const SIS: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x007 };
    pub const WIM: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x008 };
    pub const CSV: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x009 };
    pub const DFS: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x00A };
    pub const FILTER_MANAGER: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x00B };
    pub const SYMLINK: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x00C };
    pub const IIS_CACHE: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x010 };
    pub const DFSR: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x012 };
    pub const DEDUP: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x013 };
    pub const APPXSTRM: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsReserved = true, .Value = 0x014 };
    pub const NFS: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x014 };
    pub const FILE_PLACEHOLDER: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x015 };
    pub const DFM: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x016 };
    pub const WOF: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x017 };
    pub inline fn WCI(index: u1) IO_REPARSE_TAG {
        return .{ .IsMicrosoft = true, .IsDirectory = index == 0x1, .Index = index, .Value = 0x018 };
    }
    pub const GLOBAL_REPARSE: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x0019 };
    pub inline fn CLOUD(index: u4) IO_REPARSE_TAG {
        return .{ .IsMicrosoft = true, .IsDirectory = true, .Index = index, .Value = 0x01A };
    }
    pub const APPEXECLINK: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x01B };
    pub const PROJFS: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsDirectory = true, .Value = 0x01C };
    pub const LX_SYMLINK: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x01D };
    pub const STORAGE_SYNC: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x01E };
    pub const WCI_TOMBSTONE: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x01F };
    pub const UNHANDLED: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x020 };
    pub const ONEDRIVE: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x021 };
    pub const PROJFS_TOMBSTONE: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x022 };
    pub const AF_UNIX: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x023 };
    pub const LX_FIFO: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x024 };
    pub const LX_CHR: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x025 };
    pub const LX_BLK: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .Value = 0x026 };
    pub const LX_STORAGE_SYNC_FOLDER: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsDirectory = true, .Value = 0x027 };
    pub inline fn WCI_LINK(index: u1) IO_REPARSE_TAG {
        return .{ .IsMicrosoft = true, .IsSurrogate = true, .Index = index, .Value = 0x027 };
    }
    pub const DATALESS_CIM: IO_REPARSE_TAG = .{ .IsMicrosoft = true, .IsSurrogate = true, .Value = 0x28 };
};

// 参考:km/wdm.h

pub const ACCESS_MASK = packed struct(DWORD) {
    SPECIFIC: Specific = .{ .bits = 0 },
    STANDARD: Standard = .{},
    Reserved21: u3 = 0,
    ACCESS_SYSTEM_SECURITY: bool = false,
    MAXIMUM_ALLOWED: bool = false,
    Reserved26: u2 = 0,
    GENERIC: Generic = .{},

    pub const Specific = packed union {
        bits: u16,

        // 参考:km/wdm.h

        /// 定义文件与目录的访问权限
        FILE: File,
        FILE_DIRECTORY: File.Directory,
        FILE_PIPE: File.Pipe,
        /// 注册表专用访问权限。
        KEY: Key,
        /// 对象管理器中对象类型专属的访问权限。
        OBJECT_TYPE: ObjectType,
        /// 对象管理器目录专属访问权限。
        DIRECTORY: Directory,
        /// 对象管理器符号链接专用访问权限。
        SYMBOLIC_LINK: SymbolicLink,
        /// 节访问权限。
        SECTION: Section,
        /// 会话特定访问权限。
        SESSION: Session,
        /// 进程专属访问权限。
        PROCESS: Process,
        /// 线程专属访问权限。
        THREAD: Thread,
        /// 分区特定访问权限。
        MEMORY_PARTITION: MemoryPartition,
        /// 事务管理器权限的通用映射。
        TRANSACTIONMANAGER: TransactionManager,
        /// 事务权限的通用映射。
        TRANSACTION: Transaction,
        /// 资源管理器权限的通用映射。
        RESOURCEMANAGER: ResourceManager,
        /// 事务登记权限的通用映射。
        ENLISTMENT: Enlistment,
        /// 事件特定访问权限。
        EVENT: Event,
        /// 信号量专用访问权限。
        SEMAPHORE: Semaphore,

        // 参考:km/ntifs.h

        /// 令牌专属访问权限。
        TOKEN: Token,

        // um/winnt.h

        /// 作业对象专属访问权限。
        JOB_OBJECT: JobObject,
        /// 互斥对象专用访问权限。
        MUTANT: Mutant,
        /// 计时器专用访问权限。
        TIMER: Timer,
        /// 输入输出完成对象的特定访问权限。
        IO_COMPLETION: IoCompletion,

        pub const File = packed struct(u16) {
            READ_DATA: bool = false,
            WRITE_DATA: bool = false,
            APPEND_DATA: bool = false,
            READ_EA: bool = false,
            WRITE_EA: bool = false,
            EXECUTE: bool = false,
            Reserved6: u1 = 0,
            READ_ATTRIBUTES: bool = false,
            WRITE_ATTRIBUTES: bool = false,
            Reserved9: u7 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .FILE = .{
                    .READ_DATA = true,
                    .WRITE_DATA = true,
                    .APPEND_DATA = true,
                    .READ_EA = true,
                    .WRITE_EA = true,
                    .EXECUTE = true,
                    .Reserved6 = maxInt(@FieldType(File, "Reserved6")),
                    .READ_ATTRIBUTES = true,
                    .WRITE_ATTRIBUTES = true,
                } },
            };

            pub const GENERIC_READ: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .READ,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .FILE = .{
                    .READ_DATA = true,
                    .READ_ATTRIBUTES = true,
                    .READ_EA = true,
                } },
            };

            pub const GENERIC_WRITE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .WRITE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .FILE = .{
                    .WRITE_DATA = true,
                    .WRITE_ATTRIBUTES = true,
                    .WRITE_EA = true,
                    .APPEND_DATA = true,
                } },
            };

            pub const GENERIC_EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .EXECUTE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .FILE = .{
                    .READ_ATTRIBUTES = true,
                    .EXECUTE = true,
                } },
            };

            pub const Directory = packed struct(u16) {
                LIST: bool = false,
                ADD_FILE: bool = false,
                ADD_SUBDIRECTORY: bool = false,
                READ_EA: bool = false,
                WRITE_EA: bool = false,
                TRAVERSE: bool = false,
                DELETE_CHILD: bool = false,
                READ_ATTRIBUTES: bool = false,
                WRITE_ATTRIBUTES: bool = false,
                Reserved9: u7 = 0,
            };

            pub const Pipe = packed struct(u16) {
                READ_DATA: bool = false,
                WRITE_DATA: bool = false,
                CREATE_PIPE_INSTANCE: bool = false,
                Reserved3: u4 = 0,
                READ_ATTRIBUTES: bool = false,
                WRITE_ATTRIBUTES: bool = false,
                Reserved9: u7 = 0,
            };
        };

        pub const Key = packed struct(u16) {
            /// 查询注册表键值所需的权限。
            QUERY_VALUE: bool = false,
            /// 创建、删除或设置注册表值所需的权限。
            SET_VALUE: bool = false,
            /// 创建注册表项的子键所需的权限。
            CREATE_SUB_KEY: bool = false,
            /// 枚举注册表键的子键所需的权限。
            ENUMERATE_SUB_KEYS: bool = false,
            /// 请求注册表键或其子键的更改通知时所需的权限。
            NOTIFY: bool = false,
            /// 预留供系统使用。
            CREATE_LINK: bool = false,
            Reserved6: u2 = 0,
            /// 表示 64 位 Windows 上的应用程序应使用 64 位注册表视图。
            /// 32 位 Windows 忽略此标志。
            WOW64_64KEY: bool = false,
            /// 指示 64 位 Windows 上的应用程序应操作 32 位注册表视图。
            /// 32 位 Windows 忽略此标志。
            WOW64_32KEY: bool = false,
            Reserved10: u6 = 0,

            pub const WOW64_RES: ACCESS_MASK = .{
                .SPECIFIC = .{ .KEY = .{
                    .WOW64_32KEY = true,
                    .WOW64_64KEY = true,
                } },
            };

            /// 组合 STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS 和 KEY_NOTIFY 的值。
            pub const READ: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .READ,
                    .SYNCHRONIZE = false,
                },
                .SPECIFIC = .{ .KEY = .{
                    .QUERY_VALUE = true,
                    .ENUMERATE_SUB_KEYS = true,
                    .NOTIFY = true,
                } },
            };

            /// 组合 STANDARD_RIGHTS_WRITE、KEY_SET_VALUE 和 KEY_CREATE_SUB_KEY 访问权限。
            pub const WRITE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .WRITE,
                    .SYNCHRONIZE = false,
                },
                .SPECIFIC = .{ .KEY = .{
                    .SET_VALUE = true,
                    .CREATE_SUB_KEY = true,
                } },
            };

            /// 等同于 KEY_READ。
            pub const EXECUTE = READ;

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .ALL,
                    .SYNCHRONIZE = false,
                },
                .SPECIFIC = .{ .KEY = .{
                    .QUERY_VALUE = true,
                    .SET_VALUE = true,
                    .CREATE_SUB_KEY = true,
                    .ENUMERATE_SUB_KEYS = true,
                    .NOTIFY = true,
                    .CREATE_LINK = true,
                } },
            };
        };

        pub const ObjectType = packed struct(u16) {
            CREATE: bool = false,
            Reserved1: u15 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .OBJECT_TYPE = .{
                    .CREATE = true,
                } },
            };
        };

        pub const Directory = packed struct(u16) {
            QUERY: bool = false,
            TRAVERSE: bool = false,
            CREATE_OBJECT: bool = false,
            CREATE_SUBDIRECTORY: bool = false,
            Reserved3: u12 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .DIRECTORY = .{
                    .QUERY = true,
                    .TRAVERSE = true,
                    .CREATE_OBJECT = true,
                    .CREATE_SUBDIRECTORY = true,
                } },
            };
        };

        pub const SymbolicLink = packed struct(u16) {
            QUERY: bool = false,
            SET: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .SYMBOLIC_LINK = .{
                    .QUERY = true,
                } },
            };

            pub const ALL_ACCESS_EX: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .SYMBOLIC_LINK = .{
                    .QUERY = true,
                    .SET = true,
                    .Reserved2 = maxInt(@FieldType(SymbolicLink, "Reserved2")),
                } },
            };
        };

        pub const Section = packed struct(u16) {
            QUERY: bool = false,
            MAP_WRITE: bool = false,
            MAP_READ: bool = false,
            MAP_EXECUTE: bool = false,
            EXTEND_SIZE: bool = false,
            /// 不包含在 `ALL_ACCESS` 中
            MAP_EXECUTE_EXPLICIT: bool = false,
            Reserved6: u10 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .SECTION = .{
                    .QUERY = true,
                    .MAP_WRITE = true,
                    .MAP_READ = true,
                    .MAP_EXECUTE = true,
                    .EXTEND_SIZE = true,
                } },
            };
        };

        pub const Session = packed struct(u16) {
            QUERY_ACCESS: bool = false,
            MODIFY_ACCESS: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .SESSION = .{
                    .QUERY_ACCESS = true,
                    .MODIFY_ACCESS = true,
                } },
            };
        };

        pub const Process = packed struct(u16) {
            TERMINATE: bool = false,
            CREATE_THREAD: bool = false,
            SET_SESSIONID: bool = false,
            VM_OPERATION: bool = false,
            VM_READ: bool = false,
            VM_WRITE: bool = false,
            DUP_HANDLE: bool = false,
            CREATE_PROCESS: bool = false,
            SET_QUOTA: bool = false,
            SET_INFORMATION: bool = false,
            QUERY_INFORMATION: bool = false,
            SUSPEND_RESUME: bool = false,
            QUERY_LIMITED_INFORMATION: bool = false,
            SET_LIMITED_INFORMATION: bool = false,
            Reserved14: u2 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .PROCESS = .{
                    .TERMINATE = true,
                    .CREATE_THREAD = true,
                    .SET_SESSIONID = true,
                    .VM_OPERATION = true,
                    .VM_READ = true,
                    .VM_WRITE = true,
                    .DUP_HANDLE = true,
                    .CREATE_PROCESS = true,
                    .SET_QUOTA = true,
                    .SET_INFORMATION = true,
                    .QUERY_INFORMATION = true,
                    .SUSPEND_RESUME = true,
                    .QUERY_LIMITED_INFORMATION = true,
                    .SET_LIMITED_INFORMATION = true,
                    .Reserved14 = maxInt(@FieldType(Process, "Reserved14")),
                } },
            };
        };

        pub const Thread = packed struct(u16) {
            TERMINATE: bool = false,
            SUSPEND_RESUME: bool = false,
            ALERT: bool = false,
            GET_CONTEXT: bool = false,
            SET_CONTEXT: bool = false,
            SET_INFORMATION: bool = false,
            QUERY_INFORMATION: bool = false,
            SET_THREAD_TOKEN: bool = false,
            IMPERSONATE: bool = false,
            DIRECT_IMPERSONATION: bool = false,
            SET_LIMITED_INFORMATION: bool = false,
            QUERY_LIMITED_INFORMATION: bool = false,
            RESUME: bool = false,
            Reserved13: u3 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .THREAD = .{
                    .TERMINATE = true,
                    .SUSPEND_RESUME = true,
                    .ALERT = true,
                    .GET_CONTEXT = true,
                    .SET_CONTEXT = true,
                    .SET_INFORMATION = true,
                    .QUERY_INFORMATION = true,
                    .SET_THREAD_TOKEN = true,
                    .IMPERSONATE = true,
                    .DIRECT_IMPERSONATION = true,
                    .SET_LIMITED_INFORMATION = true,
                    .QUERY_LIMITED_INFORMATION = true,
                    .RESUME = true,
                    .Reserved13 = maxInt(@FieldType(Thread, "Reserved13")),
                } },
            };
        };

        pub const MemoryPartition = packed struct(u16) {
            QUERY_ACCESS: bool = false,
            MODIFY_ACCESS: bool = false,
            Required2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .MEMORY_PARTITION = .{
                    .QUERY_ACCESS = true,
                    .MODIFY_ACCESS = true,
                } },
            };
        };

        pub const TransactionManager = packed struct(u16) {
            QUERY_INFORMATION: bool = false,
            SET_INFORMATION: bool = false,
            RECOVER: bool = false,
            RENAME: bool = false,
            CREATE_RM: bool = false,
            /// 以下权限仅供 DTC 使用;它将被弃用,其他调用方不应依赖它。
            BIND_TRANSACTION: bool = false,
            Reserved6: u10 = 0,

            pub const GENERIC_READ: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .READ },
                .SPECIFIC = .{ .TRANSACTIONMANAGER = .{
                    .QUERY_INFORMATION = true,
                } },
            };

            pub const GENERIC_WRITE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .WRITE },
                .SPECIFIC = .{ .TRANSACTIONMANAGER = .{
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .RENAME = true,
                    .CREATE_RM = true,
                } },
            };

            pub const GENERIC_EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .EXECUTE },
                .SPECIFIC = .{ .TRANSACTIONMANAGER = .{} },
            };

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .TRANSACTIONMANAGER = .{
                    .QUERY_INFORMATION = true,
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .RENAME = true,
                    .CREATE_RM = true,
                    .BIND_TRANSACTION = true,
                } },
            };
        };

        pub const Transaction = packed struct(u16) {
            QUERY_INFORMATION: bool = false,
            SET_INFORMATION: bool = false,
            ENLIST: bool = false,
            COMMIT: bool = false,
            ROLLBACK: bool = false,
            PROPAGATE: bool = false,
            RIGHT_RESERVED1: bool = false,
            Reserved7: u9 = 0,

            pub const GENERIC_READ: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .READ,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TRANSACTION = .{
                    .QUERY_INFORMATION = true,
                } },
            };

            pub const GENERIC_WRITE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .WRITE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TRANSACTION = .{
                    .SET_INFORMATION = true,
                    .COMMIT = true,
                    .ENLIST = true,
                    .ROLLBACK = true,
                    .PROPAGATE = true,
                } },
            };

            pub const GENERIC_EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .EXECUTE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TRANSACTION = .{
                    .COMMIT = true,
                    .ROLLBACK = true,
                } },
            };

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TRANSACTION = .{
                    .QUERY_INFORMATION = true,
                    .SET_INFORMATION = true,
                    .COMMIT = true,
                    .ENLIST = true,
                    .ROLLBACK = true,
                    .PROPAGATE = true,
                } },
            };

            pub const RESOURCE_MANAGER_RIGHTS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .{
                        .READ_CONTROL = true,
                    },
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TRANSACTION = .{
                    .QUERY_INFORMATION = true,
                    .SET_INFORMATION = true,
                    .ENLIST = true,
                    .ROLLBACK = true,
                    .PROPAGATE = true,
                } },
            };
        };

        pub const ResourceManager = packed struct(u16) {
            QUERY_INFORMATION: bool = false,
            SET_INFORMATION: bool = false,
            RECOVER: bool = false,
            ENLIST: bool = false,
            GET_NOTIFICATION: bool = false,
            REGISTER_PROTOCOL: bool = false,
            COMPLETE_PROPAGATION: bool = false,
            Reserved7: u9 = 0,

            pub const GENERIC_READ: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .READ,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .RESOURCEMANAGER = .{
                    .QUERY_INFORMATION = true,
                } },
            };

            pub const GENERIC_WRITE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .WRITE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .RESOURCEMANAGER = .{
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .ENLIST = true,
                    .GET_NOTIFICATION = true,
                    .REGISTER_PROTOCOL = true,
                    .COMPLETE_PROPAGATION = true,
                } },
            };

            pub const GENERIC_EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .EXECUTE,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .RESOURCEMANAGER = .{
                    .RECOVER = true,
                    .ENLIST = true,
                    .GET_NOTIFICATION = true,
                    .COMPLETE_PROPAGATION = true,
                } },
            };

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .RESOURCEMANAGER = .{
                    .QUERY_INFORMATION = true,
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .ENLIST = true,
                    .GET_NOTIFICATION = true,
                    .REGISTER_PROTOCOL = true,
                    .COMPLETE_PROPAGATION = true,
                } },
            };
        };

        pub const Enlistment = packed struct(u16) {
            QUERY_INFORMATION: bool = false,
            SET_INFORMATION: bool = false,
            RECOVER: bool = false,
            SUBORDINATE_RIGHTS: bool = false,
            SUPERIOR_RIGHTS: bool = false,
            Reserved5: u11 = 0,

            pub const GENERIC_READ: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .READ },
                .SPECIFIC = .{ .ENLISTMENT = .{
                    .QUERY_INFORMATION = true,
                } },
            };

            pub const GENERIC_WRITE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .WRITE },
                .SPECIFIC = .{ .ENLISTMENT = .{
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .SUBORDINATE_RIGHTS = true,
                    .SUPERIOR_RIGHTS = true,
                } },
            };

            pub const GENERIC_EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .EXECUTE },
                .SPECIFIC = .{ .ENLISTMENT = .{
                    .RECOVER = true,
                    .SUBORDINATE_RIGHTS = true,
                    .SUPERIOR_RIGHTS = true,
                } },
            };

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .ENLISTMENT = .{
                    .QUERY_INFORMATION = true,
                    .SET_INFORMATION = true,
                    .RECOVER = true,
                    .SUBORDINATE_RIGHTS = true,
                    .SUPERIOR_RIGHTS = true,
                } },
            };
        };

        pub const Event = packed struct(u16) {
            QUERY_STATE: bool = false,
            MODIFY_STATE: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .EVENT = .{
                    .QUERY_STATE = true,
                    .MODIFY_STATE = true,
                } },
            };
        };

        pub const Semaphore = packed struct(u16) {
            QUERY_STATE: bool = false,
            MODIFY_STATE: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .SEMAPHORE = .{
                    .QUERY_STATE = true,
                    .MODIFY_STATE = true,
                } },
            };
        };

        pub const Token = packed struct(u16) {
            ASSIGN_PRIMARY: bool = false,
            DUPLICATE: bool = false,
            IMPERSONATE: bool = false,
            QUERY: bool = false,
            QUERY_SOURCE: bool = false,
            ADJUST_PRIVILEGES: bool = false,
            ADJUST_GROUPS: bool = false,
            ADJUST_DEFAULT: bool = false,
            ADJUST_SESSIONID: bool = false,
            Reserved9: u7 = 0,

            pub const ALL_ACCESS_P: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .TOKEN = .{
                    .ASSIGN_PRIMARY = true,
                    .DUPLICATE = true,
                    .IMPERSONATE = true,
                    .QUERY = true,
                    .QUERY_SOURCE = true,
                    .ADJUST_PRIVILEGES = true,
                    .ADJUST_GROUPS = true,
                    .ADJUST_DEFAULT = true,
                } },
            };

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED },
                .SPECIFIC = .{ .TOKEN = .{
                    .ASSIGN_PRIMARY = true,
                    .DUPLICATE = true,
                    .IMPERSONATE = true,
                    .QUERY = true,
                    .QUERY_SOURCE = true,
                    .ADJUST_PRIVILEGES = true,
                    .ADJUST_GROUPS = true,
                    .ADJUST_DEFAULT = true,
                    .ADJUST_SESSIONID = true,
                } },
            };

            pub const READ: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .READ },
                .SPECIFIC = .{ .TOKEN = .{
                    .QUERY = true,
                } },
            };

            pub const WRITE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .WRITE },
                .SPECIFIC = .{ .TOKEN = .{
                    .ADJUST_PRIVILEGES = true,
                    .ADJUST_GROUPS = true,
                    .ADJUST_DEFAULT = true,
                } },
            };

            pub const EXECUTE: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .EXECUTE },
                .SPECIFIC = .{ .TOKEN = .{} },
            };

            pub const TRUST_CONSTRAINT_MASK: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .READ },
                .SPECIFIC = .{ .TOKEN = .{
                    .QUERY = true,
                    .QUERY_SOURCE = true,
                } },
            };

            pub const TRUST_ALLOWED_MASK: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .READ },
                .SPECIFIC = .{ .TOKEN = .{
                    .QUERY = true,
                    .QUERY_SOURCE = true,
                    .DUPLICATE = true,
                    .IMPERSONATE = true,
                } },
            };
        };

        pub const JobObject = packed struct(u16) {
            ASSIGN_PROCESS: bool = false,
            SET_ATTRIBUTES: bool = false,
            QUERY: bool = false,
            TERMINATE: bool = false,
            SET_SECURITY_ATTRIBUTES: bool = false,
            IMPERSONATE: bool = false,
            Reserved6: u10 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .JOB_OBJECT = .{
                    .ASSIGN_PROCESS = true,
                    .SET_ATTRIBUTES = true,
                    .QUERY = true,
                    .TERMINATE = true,
                    .SET_SECURITY_ATTRIBUTES = true,
                    .IMPERSONATE = true,
                } },
            };
        };

        pub const Mutant = packed struct(u16) {
            QUERY_STATE: bool = false,
            Reserved1: u15 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .MUTANT = .{
                    .QUERY_STATE = true,
                } },
            };
        };

        pub const Timer = packed struct(u16) {
            QUERY_STATE: bool = false,
            MODIFY_STATE: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{
                    .RIGHTS = .REQUIRED,
                    .SYNCHRONIZE = true,
                },
                .SPECIFIC = .{ .TIMER = .{
                    .QUERY_STATE = true,
                    .MODIFY_STATE = true,
                } },
            };
        };

        pub const IoCompletion = packed struct(u16) {
            Reserved0: u1 = 0,
            MODIFY_STATE: bool = false,
            Reserved2: u14 = 0,

            pub const ALL_ACCESS: ACCESS_MASK = .{
                .STANDARD = .{ .RIGHTS = .REQUIRED, .SYNCHRONIZE = true },
                .SPECIFIC = .{ .IO_COMPLETION = .{
                    .Reserved0 = maxInt(@FieldType(IoCompletion, "Reserved0")),
                    .MODIFY_STATE = true,
                } },
            };
        };

        pub const RIGHTS_ALL: Specific = .{ .bits = maxInt(@FieldType(Specific, "bits")) };
    };

    pub const Standard = packed struct(u5) {
        RIGHTS: Rights = .{},
        SYNCHRONIZE: bool = false,

        pub const RIGHTS_ALL: Standard = .{
            .RIGHTS = .ALL,
            .SYNCHRONIZE = true,
        };

        pub const Rights = packed struct(u4) {
            DELETE: bool = false,
            READ_CONTROL: bool = false,
            WRITE_DAC: bool = false,
            WRITE_OWNER: bool = false,

            pub const REQUIRED: Rights = .{
                .DELETE = true,
                .READ_CONTROL = true,
                .WRITE_DAC = true,
                .WRITE_OWNER = true,
            };

            pub const READ: Rights = .{
                .READ_CONTROL = true,
            };
            pub const WRITE: Rights = .{
                .READ_CONTROL = true,
            };
            pub const EXECUTE: Rights = .{
                .READ_CONTROL = true,
            };

            pub const ALL = REQUIRED;
        };
    };

    pub const Generic = packed struct(u4) {
        ALL: bool = false,
        EXECUTE: bool = false,
        WRITE: bool = false,
        READ: bool = false,
    };
};

pub const DEVICE_TYPE = packed struct(ULONG) {
    FileDevice: CTL_CODE.FILE_DEVICE,
    Reserved16: u16 = 0,
};

pub const FS_INFORMATION_CLASS = enum(c_int) {
    Volume = 1,
    Label = 2,
    Size = 3,
    Device = 4,
    Attribute = 5,
    Control = 6,
    FullSize = 7,
    ObjectId = 8,
    DriverPath = 9,
    VolumeFlags = 10,
    SectorSize = 11,
    DataCopy = 12,
    MetadataSize = 13,
    FullSizeEx = 14,
    Guid = 15,
    _,

    pub const Maximum: @typeInfo(@This()).@"enum".tag_type = 1 + @typeInfo(@This()).@"enum".field_names.len;
};

pub const SECTION_INHERIT = enum(c_int) {
    Share = 1,
    Unmap = 2,
};

pub const PAGE = packed struct(ULONG) {
    NOACCESS: bool = false,
    READONLY: bool = false,
    READWRITE: bool = false,
    WRITECOPY: bool = false,

    EXECUTE: bool = false,
    EXECUTE_READ: bool = false,
    EXECUTE_READWRITE: bool = false,
    EXECUTE_WRITECOPY: bool = false,

    GUARD: bool = false,
    NOCACHE: bool = false,
    WRITECOMBINE: bool = false,

    GRAPHICS_NOACCESS: bool = false,
    GRAPHICS_READONLY: bool = false,
    GRAPHICS_READWRITE: bool = false,
    GRAPHICS_EXECUTE: bool = false,
    GRAPHICS_EXECUTE_READ: bool = false,
    GRAPHICS_EXECUTE_READWRITE: bool = false,
    GRAPHICS_COHERENT: bool = false,
    GRAPHICS_NOCACHE: bool = false,

    Reserved19: u12 = 0,

    REVERT_TO_FILE_MAP: bool = false,

    pub fn fromProtection(protection: std.process.MemoryProtection) ?PAGE {
        // TODO https://github.com/ziglang/zig/issues/22214
        return switch (@as(u3, @bitCast(protection))) {
            0b000 => .{ .NOACCESS = true },
            0b001 => .{ .READONLY = true },
            0b010 => null,
            0b011 => .{ .READWRITE = true },
            0b100 => .{ .EXECUTE = true },
            0b101 => .{ .EXECUTE_READ = true },
            0b110 => null,
            0b111 => .{ .EXECUTE_READWRITE = true },
        };
    }
};

pub const MEM = struct {
    pub const ALLOCATE = packed struct(ULONG) {
        Reserved0: u12 = 0,
        COMMIT: bool = false,
        RESERVE: bool = false,
        REPLACE_PLACEHOLDER: bool = false,
        Reserved15: u3 = 0,
        RESERVE_PLACEHOLDER: bool = false,
        RESET: bool = false,
        TOP_DOWN: bool = false,
        WRITE_WATCH: bool = false,
        PHYSICAL: bool = false,
        Reserved23: u1 = 0,
        RESET_UNDO: bool = false,
        Reserved25: u4 = 0,
        LARGE_PAGES: bool = false,
        Reserved30: u1 = 0,
        @"4MB_PAGES": bool = false,

        pub const @"64K_PAGES": ALLOCATE = .{
            .LARGE_PAGES = true,
            .PHYSICAL = true,
        };
    };

    pub const FREE = packed struct(ULONG) {
        COALESCE_PLACEHOLDERS: bool = false,
        PRESERVE_PLACEHOLDER: bool = false,
        Reserved2: u12 = 0,
        DECOMMIT: bool = false,
        RELEASE: bool = false,
        FREE: bool = false,
        Reserved17: u15 = 0,
    };

    pub const MAP = packed struct(ULONG) {
        Reserved0: u13 = 0,
        RESERVE: bool = false,
        REPLACE_PLACEHOLDER: bool = false,
        Reserved15: u14 = 0,
        LARGE_PAGES: bool = false,
        Reserved30: u2 = 0,
    };

    pub const UNMAP = packed struct(ULONG) {
        WITH_TRANSIENT_BOOST: bool = false,
        PRESERVE_PLACEHOLDER: bool = false,
        Reserved2: u30 = 0,
    };

    pub const EXTENDED_PARAMETER = extern struct {
        s: packed struct(ULONG64) {
            Type: TYPE,
            Reserved: u56,
        },
        u: extern union {
            ULong64: ULONG64,
            Pointer: PVOID,
            Size: SIZE_T,
            Handle: HANDLE,
            ULong: ULONG,
        },

        pub const TYPE = enum(u8) {
            InvalidType = 0,
            AddressRequirements,
            NumaNode,
            PartitionHandle,
            UserPhysicalHandle,
            AttributeFlags,
            ImageMachine,
            _,

            pub const Max: @typeInfo(@This()).@"enum".tag_type = @typeInfo(@This()).@"enum".field_names.len;
        };
    };
};

pub const SEC = packed struct(ULONG) {
    Reserved0: u17 = 0,
    HUGE_PAGES: bool = false,
    PARTITION_OWNER_HANDLE: bool = false,
    @"64K_PAGES": bool = false,
    Reserved19: u3 = 0,
    FILE: bool = false,
    IMAGE: bool = false,
    PROTECTED_IMAGE: bool = false,
    RESERVE: bool = false,
    COMMIT: bool = false,
    NOCACHE: bool = false,
    Reserved29: u1 = 0,
    WRITECOMBINE: bool = false,
    LARGE_PAGES: bool = false,

    pub const IMAGE_NO_EXECUTE: SEC = .{
        .IMAGE = true,
        .NOCACHE = true,
    };
};

pub const ERESOURCE = opaque {};

pub const VIRTUAL_MEMORY = struct {
    pub const INFORMATION_CLASS = enum(c_int) {
        Prefetch = 0,
        PagePriority = 1,
        CfgCallTarget = 2,
        PageDirtyState = 3,
        ImageHotPatch = 4,
        PhysicalContiguity = 5,
        VirtualMachinePrepopulate = 6,
        RemoveFromWorkingSet = 7,
        _,

        pub const Max: @typeInfo(@This()).@"enum".tag_type = @typeInfo(@This()).@"enum".field_names.len;
    };

    pub const MEMORY_PREFETCH_INFORMATION = extern struct {
        Flags: VM_PREFETCH,

        pub const VM_PREFETCH = packed struct(ULONG) {
            /// Windows 11 24H4 引入。
            /// 尝试将指定的一个或多个地址范围放入进程工作集,即将页面载入物理内存。
            ///
            TO_WORKING_SET: bool,
            Reserved1: u31 = 0,
        };
    };
};

pub const MEMORY_RANGE_ENTRY = extern struct {
    VirtualAddress: PVOID,
    NumberOfBytes: SIZE_T,
};

// 参考:shared/ntdef.h

pub const EVENT_TYPE = enum(c_int) {
    Notification,
    Synchronization,
};

pub const TIMER_TYPE = enum(c_int) {
    Notification,
    Synchronization,
};

pub const WAIT_TYPE = enum(c_int) {
    All,
    Any,
};

pub const LOGICAL = ULONG;

pub const NTSTATUS = @import("windows/ntstatus.zig").NTSTATUS;

// 参考:um/heapapi.h

pub fn GetProcessHeap() ?*HEAP {
    return peb().ProcessHeap;
}

// 无引用

pub fn GetCurrentProcess() HANDLE {
    const process_pseudo_handle: usize = @bitCast(@as(isize, -1));
    return @ptrFromInt(process_pseudo_handle);
}

pub fn GetCurrentProcessId() DWORD {
    return @truncate(@intFromPtr(teb().ClientId.UniqueProcess));
}

pub fn GetCurrentThread() HANDLE {
    const thread_pseudo_handle: usize = @bitCast(@as(isize, -2));
    return @ptrFromInt(thread_pseudo_handle);
}

pub fn GetCurrentThreadId() DWORD {
    return @truncate(@intFromPtr(teb().ClientId.UniqueThread));
}

pub fn GetLastError() Win32Error {
    return teb().LastErrorValue;
}

pub fn CloseHandle(hObject: HANDLE) void {
    switch (ntdll.NtClose(hObject)) {
        .SUCCESS => {},
        else => |status| unexpectedStatus(status) catch {},
    }
}

pub const CreateProcessError = error{
    FileNotFound,
    AccessDenied,
    InvalidName,
    NameTooLong,
    InvalidExe,
    SystemResources,
    FileBusy,
    Unexpected,
};

pub const CreateProcessFlags = packed struct(u32) {
    debug_process: bool = false,
    debug_only_this_process: bool = false,
    create_suspended: bool = false,
    detached_process: bool = false,
    create_new_console: bool = false,
    normal_priority_class: bool = false,
    idle_priority_class: bool = false,
    high_priority_class: bool = false,
    realtime_priority_class: bool = false,
    create_new_process_group: bool = false,
    create_unicode_environment: bool = false,
    create_separate_wow_vdm: bool = false,
    create_shared_wow_vdm: bool = false,
    create_forcedos: bool = false,
    below_normal_priority_class: bool = false,
    above_normal_priority_class: bool = false,
    inherit_parent_affinity: bool = false,
    inherit_caller_priority: bool = false,
    create_protected_process: bool = false,
    extended_startupinfo_present: bool = false,
    process_mode_background_begin: bool = false,
    process_mode_background_end: bool = false,
    create_secure_process: bool = false,
    _reserved: bool = false,
    create_breakaway_from_job: bool = false,
    create_preserve_code_authz_level: bool = false,
    create_default_error_mode: bool = false,
    create_no_window: bool = false,
    profile_user: bool = false,
    profile_kernel: bool = false,
    profile_server: bool = false,
    create_ignore_system_default: bool = false,
};

pub fn teb() *TEB {
    if (builtin.zig_backend == .stage2_c) return @ptrCast(@alignCast(struct {
        /// 这是 C 后端的临时规避措施,直到 zig 能够将
        /// C 代码放入内联汇编。
        extern fn zig_windows_teb() callconv(.c) *anyopaque;
    }.zig_windows_teb()));
    switch (native_arch) {
        .thumb => return asm (
            \\ mrc p15, 0, %[ptr], c13, c0, 2
            : [ptr] "=r" (-> *TEB),
        ),
        .aarch64 => return asm (
            \\ mov %[ptr], x18
            : [ptr] "=r" (-> *TEB),
        ),
        .x86 => {
            comptime assert(
                @offsetOf(TEB, "NtTib") + @offsetOf(@FieldType(TEB, "NtTib"), "Self") == 0x18,
            );
            return asm (
                \\ movl %%fs:0x18, %[ptr]
                : [ptr] "=r" (-> *TEB),
            );
        },
        .x86_64 => {
            comptime assert(
                @offsetOf(TEB, "NtTib") + @offsetOf(@FieldType(TEB, "NtTib"), "Self") == 0x30,
            );
            return asm (
                \\ movq %%gs:0x30, %[ptr]
                : [ptr] "=r" (-> *TEB),
            );
        },
        else => @compileError("unsupported arch"),
    }
}

pub fn peb() *PEB {
    if (builtin.zig_backend == .stage2_c) return @ptrCast(@alignCast(struct {
        /// 这是 C 后端的临时规避措施,直到 zig 能够将
        /// C 代码放入内联汇编。
        extern fn zig_windows_peb() callconv(.c) *anyopaque;
    }.zig_windows_peb()));
    switch (native_arch) {
        .aarch64 => {
            comptime assert(@offsetOf(TEB, "ProcessEnvironmentBlock") == 0x60);
            return asm (
                \\ ldr %[ptr], [x18, #0x60]
                : [ptr] "=r" (-> *PEB),
            );
        },
        .x86 => {
            comptime assert(@offsetOf(TEB, "ProcessEnvironmentBlock") == 0x30);
            return asm (
                \\ movl %%fs:0x30, %[ptr]
                : [ptr] "=r" (-> *PEB),
            );
        },
        .x86_64 => {
            comptime assert(@offsetOf(TEB, "ProcessEnvironmentBlock") == 0x60);
            return asm (
                \\ movq %%gs:0x60, %[ptr]
                : [ptr] "=r" (-> *PEB),
            );
        },
        else => {},
    }
    return teb().ProcessEnvironmentBlock;
}

/// 文件时间是一个 64 位值,表示自协调世界时
/// (UTC)1601 年 1 月 1 日零点起
/// 经过的 100 纳秒时间间隔数量。
/// 此函数返回自标准纪元起的纳秒数,
/// 采用 POSIX 纪元(公元 1970 年 1 月 1 日)。
pub fn fromSysTime(hns: i64) Io.Timestamp {
    const adjusted_epoch: i128 = hns + std.time.epoch.windows * (std.time.ns_per_s / 100);
    return .fromNanoseconds(@intCast(adjusted_epoch * 100));
}

pub fn toSysTime(ns: Io.Timestamp) i64 {
    const hns = @divFloor(ns.nanoseconds, 100);
    return @as(i64, @intCast(hns)) - std.time.epoch.windows * (std.time.ns_per_s / 100);
}

/// Windows 上且不在编译期时使用 RtlUpcaseUnicodeChar,
/// 避免包含冗余的大写字符数据副本。
pub inline fn toUpperWtf16(c: u16) u16 {
    return (if (builtin.os.tag != .windows or @inComptime()) nls.upcaseW else ntdll.RtlUpcaseUnicodeChar)(c);
}

/// 以等同于启用大小写不敏感比较的
/// `RtlEqualUnicodeString` 的方式,比较两个 WTF16 字符串。
/// 此函数可在任何目标上调用。
pub fn eqlIgnoreCaseWtf16(a: []const u16, b: []const u16) bool {
    if (@inComptime() or builtin.os.tag != .windows) {
        // 此函数逐代码单元,即逐个 u16 比较字符串,
        // 因此任何长度差异都表示不相等。换言之,转换表中不可能存在
        // 会改变大写/小写形式所需 WTF-16 代码单元数量的转换,
        // 因为只有 <= max(u16) 的码点才有资格
        // 参与转换。
        if (a.len != b.len) return false;

        for (a, b) |a_c, b_c| {
            // 这些切片始终采用 WTF-16 小端序,因此需要将元素转换为本机
            // 字节序后再进行大写转换。
            const a_c_native = std.mem.littleToNative(u16, a_c);
            const b_c_native = std.mem.littleToNative(u16, b_c);
            if (a_c != b_c and toUpperWtf16(a_c_native) != toUpperWtf16(b_c_native)) {
                return false;
            }
        }
        return true;
    }
    // 在 Windows 上且不在编译期时使用 RtlEqualUnicodeString,
    // 避免包含冗余的大写字符数据副本。
    return ntdll.RtlEqualUnicodeString(&.init(a), &.init(b), .TRUE).toBool();
}

/// 以等同于启用大小写不敏感比较的
/// `RtlEqualUnicodeString` 的方式,比较两个 WTF-8 字符串。
/// 此函数可在任何目标上调用。
/// 假定 `a` 和 `b` 均为有效 WTF-8。
pub fn eqlIgnoreCaseWtf8(a: []const u8, b: []const u8) bool {
    // 此处不能检查长度相等,因为某些
    // 码点的大写 UTF-8 表示长度不同于
    // 其小写形式,例如 U+0250(2 字节)<-> U+2C6F(3 字节)。
    // Windows 使用的大写数据中有 7 个这样的码点。

    var a_wtf8_it = std.unicode.Wtf8View.initUnchecked(a).iterator();
    var b_wtf8_it = std.unicode.Wtf8View.initUnchecked(b).iterator();

    while (true) {
        const a_cp = a_wtf8_it.nextCodepoint() orelse break;
        const b_cp = b_wtf8_it.nextCodepoint() orelse return false;

        if (a_cp <= maxInt(u16) and b_cp <= maxInt(u16)) {
            if (a_cp != b_cp and toUpperWtf16(@intCast(a_cp)) != toUpperWtf16(@intCast(b_cp))) {
                return false;
            }
        } else if (a_cp != b_cp) {
            return false;
        }
    }
    // 确保 b 中没有剩余码点。
    if (b_wtf8_it.nextCodepoint() != null) return false;

    return true;
}

fn testEqlIgnoreCase(comptime expect_eql: bool, comptime a: []const u8, comptime b: []const u8) !void {
    try std.testing.expectEqual(expect_eql, eqlIgnoreCaseWtf8(a, b));
    try std.testing.expectEqual(expect_eql, eqlIgnoreCaseWtf16(
        std.unicode.utf8ToUtf16LeStringLiteral(a),
        std.unicode.utf8ToUtf16LeStringLiteral(b),
    ));

    try comptime std.testing.expect(expect_eql == eqlIgnoreCaseWtf8(a, b));
    try comptime std.testing.expect(expect_eql == eqlIgnoreCaseWtf16(
        std.unicode.utf8ToUtf16LeStringLiteral(a),
        std.unicode.utf8ToUtf16LeStringLiteral(b),
    ));
}

test "eqlIgnoreCaseWtf16/Wtf8" {
    try testEqlIgnoreCase(true, "\x01 a B Λ ɐ", "\x01 A b λ Ɐ");
    // 对于 >= U+10000 的码点,不执行忽略大小写比较。
    try testEqlIgnoreCase(false, "𐓏", "𐓷");
}

/// `removeDotDirsSanitized` 的错误类型
pub const RemoveDotDirsError = error{TooManyParentDirs};

/// 从“已清理的相对路径”中移除点和双点路径分量。
/// “已清理路径”指:
///    1)所有正斜杠均已替换为反斜杠;
///    2)所有重复反斜杠均已合并;
///    3)路径为相对路径,即不以反斜杠开头。
pub fn removeDotDirsSanitized(comptime T: type, path: []T) RemoveDotDirsError!usize {
    assert(path.len == 0 or path[0] != '\\');

    var write_idx: usize = 0;
    var read_idx: usize = 0;
    while (read_idx < path.len) {
        if (path[read_idx] == '.') {
            if (read_idx + 1 == path.len)
                return write_idx;

            const after_dot = path[read_idx + 1];
            if (after_dot == '\\') {
                read_idx += 2;
                continue;
            }
            if (after_dot == '.' and (read_idx + 2 == path.len or path[read_idx + 2] == '\\')) {
                if (write_idx == 0) return error.TooManyParentDirs;
                assert(write_idx >= 2);
                write_idx -= 1;
                while (true) {
                    write_idx -= 1;
                    if (write_idx == 0) break;
                    if (path[write_idx] == '\\') {
                        write_idx += 1;
                        break;
                    }
                }
                if (read_idx + 2 == path.len)
                    return write_idx;
                read_idx += 3;
                continue;
            }
        }

        // 跳至下一个路径分隔符
        while (true) : (read_idx += 1) {
            if (read_idx == path.len)
                return write_idx;
            path[write_idx] = path[read_idx];
            write_idx += 1;
            if (path[read_idx] == '\\')
                break;
        }
        read_idx += 1;
    }
    return write_idx;
}

/// 通过以下步骤规范化 Windows 路径:
///     1) 将所有正斜杠转换为反斜杠
///     2) 合并重复的反斜杠
///     3) 移除“.”和“..”目录部分
/// 返回新路径的长度。
pub fn normalizePath(comptime T: type, path: []T) RemoveDotDirsError!usize {
    mem.replaceScalar(T, path, '/', '\\');
    const new_len = mem.collapseRepeatsLen(T, path, '\\');

    const prefix_len: usize = init: {
        if (new_len >= 1 and path[0] == '\\') break :init 1;
        if (new_len >= 2 and path[1] == ':')
            break :init if (new_len >= 3 and path[2] == '\\') @as(usize, 3) else @as(usize, 2);
        break :init 0;
    };

    return prefix_len + try removeDotDirsSanitized(T, path[prefix_len..new_len]);
}

/// 若路径以 `\??\` 开头,则返回 true。这通常表示 NT 路径,但不足以完全区分 NT 路径与 Win32 路径,因为 `\??\` 实际上不是独立前缀,而是对象管理器中特殊虚拟文件夹的路径。
///
/// 例如,`\Device\HarddiskVolume2` 和 `\DosDevices\C:` 也是 NT 路径,但无法仅通过前缀识别。
///
/// 因此,推断路径是 NT 路径还是 Win32 路径通常是错误做法,应当提前明确该信息。
///
/// 若 `T` 为 `u16`,则 `path` 应采用 WTF-16LE 编码。
///
///
///
///
///
pub fn hasCommonNtPrefix(comptime T: type, path: []const T) bool {
    // 必须恰好为 \??\,不允许正斜杠。
    const expected_wtf8_prefix = "\\??\\";
    const expected_prefix = switch (T) {
        u8 => expected_wtf8_prefix,
        u16 => std.unicode.wtf8ToWtf16LeStringLiteral(expected_wtf8_prefix),
        else => @compileError("unsupported type: " ++ @typeName(T)),
    };
    return mem.startsWith(T, path, expected_prefix);
}

/// 类似于 `RtlNtPathNameToDosPathName`,但不进行任何堆分配。
/// 可能的转换如下:
///   \??\C:\Some\Path -> C:\Some\Path
///   \??\UNC\server\share\foo -> \\server\share\foo
/// 若路径不含 NT 命名空间前缀,则返回 `error.NotNtPath`。
///
/// 功能基于以下 ReactOS 测试用例:
/// https://github.com/reactos/reactos/blob/master/modules/rostests/apitests/ntdll/RtlNtPathNameToDosPathName.c
///
/// `path` 应采用 WTF-16LE 编码。
///
/// 支持原地修改,`path` 和 `out` 可以引用同一切片。
pub fn ntToWin32Namespace(path: []const u16, out: []u16) error{ NameTooLong, NotNtPath }![]u16 {
    if (path.len > PATH_MAX_WIDE) return error.NameTooLong;
    if (!hasCommonNtPrefix(u16, path)) return error.NotNtPath;

    var dest_index: usize = 0;
    var after_prefix = path[4..]; // 在 `\??\` 之后
    // 前缀 \??\UNC\ 表示 UNC 路径,此时应将 `\??\UNC\` 替换为 `\\`(两个反斜杠)
    //
    const is_unc = after_prefix.len >= 4 and
        eqlIgnoreCaseWtf16(after_prefix[0..3], std.unicode.utf8ToUtf16LeStringLiteral("UNC")) and
        std.fs.path.PathType.windows.isSep(u16, after_prefix[3]);
    const win32_len = path.len - @as(usize, if (is_unc) 6 else 4);
    if (out.len < win32_len) return error.NameTooLong;
    if (is_unc) {
        out[0] = comptime std.mem.nativeToLittle(u16, '\\');
        dest_index += 1;
        // 需要包含 `\??\UNC\` 的最后一个 `\`
        after_prefix = path[7..];
    }
    @memmove(out[dest_index..][0..after_prefix.len], after_prefix);
    return out[0..win32_len];
}

test ntToWin32Namespace {
    const L = std.unicode.utf8ToUtf16LeStringLiteral;

    var mutable_unc_path_buf = L("\\??\\UNC\\path1\\path2").*;
    try std.testing.expectEqualSlices(u16, L("\\\\path1\\path2"), try ntToWin32Namespace(&mutable_unc_path_buf, &mutable_unc_path_buf));

    var mutable_path_buf = L("\\??\\C:\\test\\").*;
    try std.testing.expectEqualSlices(u16, L("C:\\test\\"), try ntToWin32Namespace(&mutable_path_buf, &mutable_path_buf));

    var too_small_buf: [6]u16 = undefined;
    try std.testing.expectError(error.NameTooLong, ntToWin32Namespace(L("\\??\\C:\\test"), &too_small_buf));
}

inline fn MAKELANGID(p: c_ushort, s: c_ushort) LANGID {
    return (s << 10) | p;
}

/// 调用 Windows DLL 或其他会设置 SetLastError 的函数后,
/// 遇到意外错误时调用此函数。
pub fn unexpectedError(err: Win32Error) UnexpectedError {
    @branchHint(.cold);
    if (std.options.unexpected_error_tracing) {
        std.debug.print("error.Unexpected: GetLastError({d}): {t}\n", .{ err, err });
        std.debug.dumpCurrentStackTrace(.{ .first_address = @returnAddress() });
    }
    return error.Unexpected;
}

/// 调用 Windows NtDll 后得到意外状态时,调用此函数。
///
pub fn unexpectedStatus(status: NTSTATUS) UnexpectedError {
    if (std.options.unexpected_error_tracing) {
        std.debug.print("error.Unexpected NTSTATUS=0x{x} ({s})\n", .{
            @backingInt(status),
            std.enums.tagName(NTSTATUS, status) orelse "<unnamed>",
        });
        std.debug.dumpCurrentStackTrace(.{ .first_address = @returnAddress() });
    }
    return error.Unexpected;
}

pub fn statusBug(status: NTSTATUS) UnexpectedError {
    switch (builtin.mode) {
        .debug => std.debug.panic("programmer bug caused syscall status: 0x{x} ({s})", .{
            @backingInt(status),
            std.enums.tagName(NTSTATUS, status) orelse "<unnamed>",
        }),
        else => return error.Unexpected,
    }
}

pub fn errorBug(err: Win32Error) UnexpectedError {
    switch (builtin.mode) {
        .debug => std.debug.panic("programmer bug caused syscall error: 0x{x} ({s})", .{
            @backingInt(err),
            std.enums.tagName(Win32Error, err) orelse "<unnamed>",
        }),
        else => return error.Unexpected,
    }
}

pub const Win32Error = @import("windows/win32error.zig").Win32Error;
pub const LANG = @import("windows/lang.zig");
pub const SUBLANG = @import("windows/sublang.zig");

pub const BOOL = Bool(c_int);
pub const BOOLEAN = Bool(BYTE);
pub const BYTE = u8;
pub const CHAR = u8;
pub const UCHAR = u8;
pub const FLOAT = f32;
pub const HANDLE = *anyopaque;
pub const HCRYPTPROV = ULONG_PTR;
pub const ATOM = u16;
pub const HBRUSH = *opaque {};
pub const HCURSOR = *opaque {};
pub const HICON = *opaque {};
pub const HINSTANCE = *opaque {};
pub const HMENU = *opaque {};
pub const HMODULE = *opaque {};
pub const HWND = *opaque {};
pub const HDC = *opaque {};
pub const HGLRC = *opaque {};
pub const FARPROC = *opaque {};
pub const PROC = *opaque {};
pub const INT = c_int;
pub const LPCSTR = [*:0]const CHAR;
pub const LPCVOID = *const anyopaque;
pub const LPSTR = [*:0]CHAR;
pub const LPVOID = *anyopaque;
pub const LPWSTR = [*:0]WCHAR;
pub const LPCWSTR = [*:0]const WCHAR;
pub const PVOID = *anyopaque;
pub const PWSTR = [*:0]WCHAR;
pub const PCWSTR = [*:0]const WCHAR;
/// 由 SysAllocString 分配,由 SysFreeString 释放。
pub const BSTR = [*:0]WCHAR;
pub const SIZE_T = usize;
pub const UINT = c_uint;
pub const ULONG_PTR = usize;
pub const LONG_PTR = isize;
pub const DWORD_PTR = ULONG_PTR;
pub const WCHAR = u16;
pub const WORD = u16;
pub const DWORD = u32;
pub const DWORD64 = u64;
pub const LARGE_INTEGER = i64;
pub const ULARGE_INTEGER = u64;
pub const USHORT = u16;
pub const SHORT = i16;
pub const ULONG = u32;
pub const LONG = i32;
pub const ULONG64 = u64;
pub const ULONGLONG = u64;
pub const LONGLONG = i64;
pub const LANGID = c_ushort;
pub const COLORREF = DWORD;

pub const LPARAM = LONG_PTR;

pub const va_list = *opaque {};

pub const TCHAR = @compileError("Deprecated: choose between `CHAR` or `WCHAR` directly instead.");
pub const LPTSTR = @compileError("Deprecated: choose between `LPSTR` or `LPWSTR` directly instead.");
pub const LPCTSTR = @compileError("Deprecated: choose between `LPCSTR` or `LPCWSTR` directly instead.");
pub const PTSTR = @compileError("Deprecated: choose between `PSTR` or `PWSTR` directly instead.");
pub const PCTSTR = @compileError("Deprecated: choose between `PCSTR` or `PCWSTR` directly instead.");

fn STRING(comptime C: type) type {
    return extern struct {
        Length: USHORT,
        MaximumLength: USHORT,
        Buffer: ?[*]C,

        pub const empty: @This() = .{ .Length = 0, .MaximumLength = 0, .Buffer = null };

        pub fn init(string: []const C) @This() {
            const len: USHORT = @intCast(@sizeOf(C) * string.len);
            return .{
                .Length = len,
                .MaximumLength = len,
                .Buffer = @constCast(string.ptr),
            };
        }

        pub fn initZ(string: [:0]const C) @This() {
            const len: USHORT = @intCast(@sizeOf(C) * string.len);
            return .{
                .Length = len,
                .MaximumLength = len + @sizeOf(C),
                .Buffer = @constCast(string.ptr),
            };
        }

        pub fn isEmpty(string: *const @This()) bool {
            return string.Length == 0;
        }

        pub fn slice(string: *const @This()) []C {
            return if (string.isEmpty()) &.{} else string.Buffer.?[0..@divExact(string.Length, @sizeOf(C))];
        }

        pub fn sliceZ(string: *const @This()) [:0]C {
            assert(string.Length + @sizeOf(C) <= string.MaximumLength);
            return string.Buffer.?[0..@divExact(string.Length, @sizeOf(C)) :0];
        }
    };
}
pub const ANSI_STRING = STRING(CHAR);
pub const UNICODE_STRING = STRING(WCHAR);

fn Bool(comptime BackingInteger: type) type {
    return enum(Backing) {
        /// false
        FALSE = 0,
        /// true
        _,

        /// 这不是唯一的真值;与此值进行比较始终是缺陷。
        pub const TRUE: @This() = @fromBackingInt(@intCast(1));

        pub const Backing = BackingInteger;

        pub fn toBool(b: @This()) bool {
            return b != .FALSE;
        }

        pub fn fromBool(b: bool) @This() {
            return @fromBackingInt(@intCast(@intFromBool(b)));
        }
    };
}

pub const INVALID_HANDLE_VALUE: HANDLE = @ptrFromInt(maxInt(usize));

pub const INVALID_FILE_ATTRIBUTES: DWORD = maxInt(DWORD);

pub const IO_STATUS_BLOCK = extern struct {
    // "DUMMYUNIONNAME" 展开为 "u"
    u: extern union {
        Status: NTSTATUS,
        Pointer: ?*anyopaque,
    },
    Information: ULONG_PTR,
};

pub const MAX_PATH = 260;

pub const SECURITY_ATTRIBUTES = extern struct {
    nLength: DWORD,
    lpSecurityDescriptor: ?*anyopaque,
    bInheritHandle: BOOL,
};

pub const STARTUPINFOW = extern struct {
    cb: DWORD,
    lpReserved: ?LPWSTR,
    lpDesktop: ?LPWSTR,
    lpTitle: ?LPWSTR,
    dwX: DWORD,
    dwY: DWORD,
    dwXSize: DWORD,
    dwYSize: DWORD,
    dwXCountChars: DWORD,
    dwYCountChars: DWORD,
    dwFillAttribute: DWORD,
    dwFlags: DWORD,
    wShowWindow: WORD,
    cbReserved2: WORD,
    lpReserved2: ?*BYTE,
    hStdInput: ?HANDLE,
    hStdOutput: ?HANDLE,
    hStdError: ?HANDLE,
};

pub const STARTF_FORCEONFEEDBACK = 0x00000040;
pub const STARTF_FORCEOFFFEEDBACK = 0x00000080;
pub const STARTF_PREVENTPINNING = 0x00002000;
pub const STARTF_RUNFULLSCREEN = 0x00000020;
pub const STARTF_TITLEISAPPID = 0x00001000;
pub const STARTF_TITLEISLINKNAME = 0x00000800;
pub const STARTF_UNTRUSTEDSOURCE = 0x00008000;
pub const STARTF_USECOUNTCHARS = 0x00000008;
pub const STARTF_USEFILLATTRIBUTE = 0x00000010;
pub const STARTF_USEHOTKEY = 0x00000200;
pub const STARTF_USEPOSITION = 0x00000004;
pub const STARTF_USESHOWWINDOW = 0x00000001;
pub const STARTF_USESIZE = 0x00000002;
pub const STARTF_USESTDHANDLES = 0x00000100;

pub const THREAD_START_ROUTINE = fn (LPVOID) callconv(.winapi) DWORD;
pub const USER_THREAD_START_ROUTINE = fn (LPVOID) callconv(.winapi) NTSTATUS;

pub const FILETIME = extern struct {
    dwLowDateTime: DWORD,
    dwHighDateTime: DWORD,
};

pub const GUID = extern struct {
    Data1: u32,
    Data2: u16,
    Data3: u16,
    Data4: [8]u8,

    const hex_offsets: [16]u6 = .{
        6,  4,  2,  0,
        11, 9,  16, 14,
        19, 21, 24, 26,
        28, 30, 32, 34,
    };

    pub fn parse(s: []const u8) GUID {
        assert(s[0] == '{');
        assert(s[37] == '}');
        return parseNoBraces(s[1 .. s.len - 1]) catch @panic("invalid GUID string");
    }

    pub fn parseNoBraces(s: []const u8) !GUID {
        assert(s.len == 36);
        assert(s[8] == '-');
        assert(s[13] == '-');
        assert(s[18] == '-');
        assert(s[23] == '-');
        var raw1: [4]u8 = undefined;
        var raw2: [2]u8 = undefined;
        var raw3: [2]u8 = undefined;
        var raw4: [8]u8 = undefined;
        assert((try std.fmt.hexToBytes(&raw1, s[0..8])).len == raw1.len);
        assert((try std.fmt.hexToBytes(&raw2, s[9..13])).len == raw2.len);
        assert((try std.fmt.hexToBytes(&raw3, s[14..18])).len == raw3.len);
        assert((try std.fmt.hexToBytes(raw4[0..2], s[19..23])).len == 2);
        assert((try std.fmt.hexToBytes(raw4[2..8], s[24..36])).len == 6);
        return .{
            .Data1 = @byteSwap(@as(u32, @bitCast(raw1))),
            .Data2 = @byteSwap(@as(u16, @bitCast(raw2))),
            .Data3 = @byteSwap(@as(u16, @bitCast(raw3))),
            .Data4 = raw4,
        };
    }

    pub fn format(self: GUID, w: *std.Io.Writer) std.Io.Writer.Error!void {
        return w.print("{{{x:0>8}-{x:0>4}-{x:0>4}-{x}-{x}}}", .{
            self.Data1,
            self.Data2,
            self.Data3,
            self.Data4[0..2],
            self.Data4[2..8],
        });
    }

    test parse {
        const expected: GUID = .{
            .Data1 = 0x01234567,
            .Data2 = 0x89ab,
            .Data3 = 0xef10,
            .Data4 = "\x32\x54\x76\x98\xba\xdc\xfe\x91".*,
        };
        try std.testing.expectEqual(expected, GUID.parse("{01234567-89AB-EF10-3254-7698badcfe91}"));
    }

    test format {
        const guid0: GUID = .{ .Data1 = 1, .Data2 = 1, .Data3 = 1, .Data4 = .{ 0, 1, 0, 0, 0, 0, 0, 1 } };
        try std.testing.expectFmt("{00000001-0001-0001-0001-000000000001}", "{f}", .{guid0});

        const guid1: GUID = .parse("{01234567-89AB-EF10-3254-7698badcfe91}");
        try std.testing.expectFmt("{01234567-89ab-ef10-3254-7698badcfe91}", "{f}", .{guid1});
    }
};

test {
    _ = GUID;
}

pub const COORD = extern struct {
    X: SHORT,
    Y: SHORT,
};

pub const TLS_OUT_OF_INDEXES = 4294967295;
pub const IMAGE_TLS_DIRECTORY = extern struct {
    StartAddressOfRawData: usize,
    EndAddressOfRawData: usize,
    AddressOfIndex: usize,
    AddressOfCallBacks: usize,
    SizeOfZeroFill: u32,
    Characteristics: u32,
};
pub const IMAGE_TLS_DIRECTORY64 = IMAGE_TLS_DIRECTORY;
pub const IMAGE_TLS_DIRECTORY32 = IMAGE_TLS_DIRECTORY;

pub const PIMAGE_TLS_CALLBACK = ?*const fn (PVOID, DWORD, PVOID) callconv(.winapi) void;

pub const REGSAM = ACCESS_MASK;
pub const LSTATUS = LONG;

pub const HKEY = *opaque {};

pub const HKEY_CLASSES_ROOT: HKEY = @ptrFromInt(0x80000000);
pub const HKEY_CURRENT_USER: HKEY = @ptrFromInt(0x80000001);
pub const HKEY_LOCAL_MACHINE: HKEY = @ptrFromInt(0x80000002);
pub const HKEY_USERS: HKEY = @ptrFromInt(0x80000003);
pub const HKEY_PERFORMANCE_DATA: HKEY = @ptrFromInt(0x80000004);
pub const HKEY_PERFORMANCE_TEXT: HKEY = @ptrFromInt(0x80000050);
pub const HKEY_PERFORMANCE_NLSTEXT: HKEY = @ptrFromInt(0x80000060);
pub const HKEY_CURRENT_CONFIG: HKEY = @ptrFromInt(0x80000005);
pub const HKEY_DYN_DATA: HKEY = @ptrFromInt(0x80000006);
pub const HKEY_CURRENT_USER_LOCAL_SETTINGS: HKEY = @ptrFromInt(0x80000007);

pub const RTL_QUERY_REGISTRY_TABLE = extern struct {
    QueryRoutine: RTL_QUERY_REGISTRY_ROUTINE,
    Flags: ULONG,
    Name: ?PWSTR,
    EntryContext: ?*anyopaque,
    DefaultType: REG.ValueType,
    DefaultData: ?*anyopaque,
    DefaultLength: ULONG,
};

pub const RTL_QUERY_REGISTRY_ROUTINE = ?*const fn (
    PWSTR,
    ULONG,
    ?*anyopaque,
    ULONG,
    ?*anyopaque,
    ?*anyopaque,
) callconv(.winapi) NTSTATUS;

/// 路径是完整路径
pub const RTL_REGISTRY_ABSOLUTE = 0;
/// \Registry\Machine\System\CurrentControlSet\Services
pub const RTL_REGISTRY_SERVICES = 1;
/// \Registry\Machine\System\CurrentControlSet\Control
pub const RTL_REGISTRY_CONTROL = 2;
/// \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion
pub const RTL_REGISTRY_WINDOWS_NT = 3;
/// \Registry\Machine\Hardware\DeviceMap
pub const RTL_REGISTRY_DEVICEMAP = 4;
/// \Registry\User\CurrentUser
pub const RTL_REGISTRY_USER = 5;
pub const RTL_REGISTRY_MAXIMUM = 6;

/// 低位存储注册表句柄
pub const RTL_REGISTRY_HANDLE = 0x40000000;
/// 表示键节点为可选
pub const RTL_REGISTRY_OPTIONAL = 0x80000000;

/// Name 是子键;表中剩余部分或直到下一个子键之前的内容,
/// 是要在该子键中查找的值名。
pub const RTL_QUERY_REGISTRY_SUBKEY = 0x00000001;

/// 将此表条目及所有后续条目的当前键重置为原始键。
pub const RTL_QUERY_REGISTRY_TOPKEY = 0x00000002;

/// 若未找到与此表条目匹配的项则失败。
pub const RTL_QUERY_REGISTRY_REQUIRED = 0x00000004;

/// 标记没有值名称的表项,仅要求一次回调,
/// 而非枚举全部值。
pub const RTL_QUERY_REGISTRY_NOVALUE = 0x00000008;

/// 用于禁止将 REG_MULTI_SZ 展开为多次回调,
/// 或阻止展开 REG_EXPAND_SZ 中的环境变量值。
pub const RTL_QUERY_REGISTRY_NOEXPAND = 0x00000010;

/// 忽略 QueryRoutine 字段。EntryContext 字段指向存储值的位置。
/// 对于以空字符结尾的字符串,EntryContext 指向 UNICODE_STRING 结构体,
/// 描述缓冲区的最大大小。如果 .Buffer 字段为 NULL,则
/// 分配缓冲区。
pub const RTL_QUERY_REGISTRY_DIRECT = 0x00000020;

/// 用于在查询后删除值键。
pub const RTL_QUERY_REGISTRY_DELETE = 0x00000040;

/// 将此标志与 RTL_QUERY_REGISTRY_DIRECT 标志组合,验证存储的注册表值的
/// REG_XXX 类型是否与调用者预期类型一致。
/// 若不匹配,则调用失败。
pub const RTL_QUERY_REGISTRY_TYPECHECK = 0x00000100;

/// REG_ 命名空间非常拥挤,Windows 头文件中有很多相互重叠且无关的
/// 定义,因此此处不严格照搬 Windows 头文件名称,
/// 而是添加额外命名空间以提高可读性。
pub const REG = struct {
    pub const ValueType = enum(ULONG) {
        /// 无值类型
        NONE = 0,
        /// 以空字符终止的 Unicode 字符串
        SZ = 1,
        /// 以空字符结尾的 Unicode 字符串(包含环境变量引用)。
        EXPAND_SZ = 2,
        /// 自由形式的二进制数据
        BINARY = 3,
        /// 32 位数
        DWORD = 4,
        /// 32 位数
        DWORD_BIG_ENDIAN = 5,
        /// 符号链接(Unicode)
        LINK = 6,
        /// 多个 Unicode 字符串
        MULTI_SZ = 7,
        /// 资源映射中的资源列表
        RESOURCE_LIST = 8,
        /// 硬件描述中的资源列表
        FULL_RESOURCE_DESCRIPTOR = 9,
        RESOURCE_REQUIREMENTS_LIST = 10,
        /// 64 位数字
        QWORD = 11,
        _,

        /// 32 位数值(等同于 REG_DWORD)
        pub const DWORD_LITTLE_ENDIAN: ValueType = .DWORD;
        /// 64 位数(同 REG_QWORD)
        pub const QWORD_LITTLE_ENDIAN: ValueType = .QWORD;
    };

    /// 与 NtOpenKeyEx 配合使用,或许也用于其他调用
    pub const OpenOptions = packed struct(ULONG) {
        Reserved0: u2 = 0,
        /// 为备份或还原而打开
        /// 特殊访问规则需要相应特权
        BACKUP_RESTORE: bool = false,
        /// 打开符号链接
        OPEN_LINK: bool = false,
        Reserved3: u28 = 0,
    };

    /// 与 NtLoadKeyEx 配合使用,也可能用于其他调用
    pub const LoadOptions = packed struct(ULONG) {
        /// 将整个配置单元恢复为易失形式
        WHOLE_HIVE_VOLATILE: bool = false,
        /// 将更改回退到上次刷新的状态
        REFRESH_HIVE: bool = false,
        /// 始终禁止延迟刷新此配置单元
        NO_LAZY_FLUSH: bool = false,
        /// 即使仍有子键句柄处于打开状态,也强制执行还原
        FORCE_RESTORE: bool = false,
        /// 加载对调用进程可见的注册表配置单元
        APP_HIVE: bool = false,
        /// 配置单元使用期间,其他进程无法挂载它
        PROCESS_PRIVATE: bool = false,
        /// 启动配置单元日志
        START_JOURNAL: bool = false,
        /// 以恰好 4k 的增量扩展注册表配置单元文件
        HIVE_EXACT_FILE_GROWTH: bool = false,
        /// 未为此配置单元启动资源管理器(无事务)
        HIVE_NO_RM: bool = false,
        /// 此配置单元使用旧式单日志记录
        HIVE_SINGLE_LOG: bool = false,
        /// 此注册表配置单元可能被操作系统加载器使用
        BOOT_HIVE: bool = false,
        /// 加载配置单元,并返回其根 kcb 的句柄
        LOAD_HIVE_OPEN_HANDLE: bool = false,
        /// 每次刷新时,同时将主配置单元文件大小的更改刷新到磁盘
        FLUSH_HIVE_FILE_GROWTH: bool = false,
        /// 以只读模式打开配置单元的文件。
        /// REG_APP_HIVE_OPEN_READ_ONLY 使用相同标志:
        /// 若应用配置单元此前尚未加载,则以只读模式打开其文件。
        OPEN_READ_ONLY: bool = false,
        /// 加载配置单元,但不允许进行任何修改
        IMMUTABLE: bool = false,
        /// 如果配置单元文件访问失败,不要回退为模拟调用方。
        NO_IMPERSONATION_FALLBACK: bool = false,
        Reserved16: u16 = 0,
    };
};

pub const KEY = struct {
    pub const VALUE = struct {
        /// https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/ne-wdm-_key_value_information_class
        pub const INFORMATION_CLASS = enum(c_int) {
            Basic = 0,
            Full = 1,
            Partial = 2,
            FullAlign64 = 3,
            PartialAlign64 = 4,
            Layer = 5,
            _,

            pub const Max: @typeInfo(@This()).@"enum".tag_type = @typeInfo(@This()).@"enum".field_names.len;
        };

        pub const PARTIAL_INFORMATION = extern struct {
            TitleIndex: ULONG,
            Type: REG.ValueType,
            DataLength: ULONG,
            Data: [0]UCHAR,

            pub fn data(info: *const PARTIAL_INFORMATION) []const UCHAR {
                const ptr: [*]const UCHAR = @ptrCast(&info.Data);
                return ptr[0..info.DataLength];
            }
        };
    };
};

pub const ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x4;
pub const DISABLE_NEWLINE_AUTO_RETURN = 0x8;

pub const FOREGROUND_BLUE = 0x0001;
pub const FOREGROUND_GREEN = 0x0002;
pub const FOREGROUND_RED = 0x0004;
pub const FOREGROUND_INTENSITY = 0x0008;
pub const BACKGROUND_BLUE = 0x0010;
pub const BACKGROUND_GREEN = 0x0020;
pub const BACKGROUND_RED = 0x0040;
pub const BACKGROUND_INTENSITY = 0x0080;

pub const LIST_ENTRY = extern struct {
    Flink: *LIST_ENTRY,
    Blink: *LIST_ENTRY,
};

pub const RTL_CRITICAL_SECTION_DEBUG = extern struct {
    Type: WORD,
    CreatorBackTraceIndex: WORD,
    CriticalSection: *RTL_CRITICAL_SECTION,
    ProcessLocksList: LIST_ENTRY,
    EntryCount: DWORD,
    ContentionCount: DWORD,
    Flags: DWORD,
    CreatorBackTraceIndexHigh: WORD,
    SpareWORD: WORD,
};

pub const RTL_CRITICAL_SECTION = extern struct {
    DebugInfo: *RTL_CRITICAL_SECTION_DEBUG,
    LockCount: LONG,
    RecursionCount: LONG,
    OwningThread: HANDLE,
    LockSemaphore: HANDLE,
    SpinCount: ULONG_PTR,
};

pub const CRITICAL_SECTION = RTL_CRITICAL_SECTION;
pub const INIT_ONCE = RTL_RUN_ONCE;
pub const INIT_ONCE_STATIC_INIT = RTL_RUN_ONCE_INIT;
pub const INIT_ONCE_FN = *const fn (InitOnce: *INIT_ONCE, Parameter: ?*anyopaque, Context: ?*anyopaque) callconv(.winapi) BOOL;

pub const RTL_RUN_ONCE = extern struct {
    Ptr: ?*anyopaque,
};

pub const RTL_RUN_ONCE_INIT = RTL_RUN_ONCE{ .Ptr = null };

/// > 路径最大长度 32,767 字符只是近似值,因为“\\?\”
/// > 前缀可能在运行时被系统扩展成更长的字符串,
/// > 且扩展后的长度计入总长度。
/// 来自 https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file#maximum-path-length-limitation
pub const PATH_MAX_WIDE = 32767;

/// >[每个文件名组成部分的长度]最多可达 GetVolumeInformation 函数的 lpMaximumComponentLength 参数所返回的值
/// >(此值通常为 255 个字符)
/// 来源:https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation
///
/// > 存储在变量中的值(lpMaximumComponentLength 指向该变量)用于指示指定文件系统是否支持长文件名。例如,对于支持长文件名的 FAT 文件系统,该函数存储值 255,而不是先前的 8.3 指示值。使用 NTFS 文件系统的系统同样可以支持长文件名。
/// 来源:https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-getvolumeinformationw
///
/// 这里假设 lpMaximumComponentLength 虽然可能变化,但永远不会大于 255。
///
/// TODO: 进一步验证此假设。
///
///
///
///
///
///
pub const NAME_MAX = 255;

pub const EXCEPTION_DATATYPE_MISALIGNMENT = 0x80000002;
pub const EXCEPTION_ACCESS_VIOLATION = 0xc0000005;
pub const EXCEPTION_ILLEGAL_INSTRUCTION = 0xc000001d;
pub const EXCEPTION_STACK_OVERFLOW = 0xc00000fd;
pub const EXCEPTION_CONTINUE_SEARCH = 0;

pub const EXCEPTION_RECORD = extern struct {
    ExceptionCode: u32,
    ExceptionFlags: u32,
    ExceptionRecord: *EXCEPTION_RECORD,
    ExceptionAddress: *anyopaque,
    NumberParameters: u32,
    ExceptionInformation: [15]usize,
};

pub const FLOATING_SAVE_AREA = switch (native_arch) {
    .x86 => extern struct {
        ControlWord: DWORD,
        StatusWord: DWORD,
        TagWord: DWORD,
        ErrorOffset: DWORD,
        ErrorSelector: DWORD,
        DataOffset: DWORD,
        DataSelector: DWORD,
        RegisterArea: [80]BYTE,
        Cr0NpxState: DWORD,
    },
    else => @compileError("FLOATING_SAVE_AREA only defined on x86"),
};

pub const M128A = switch (native_arch) {
    .x86_64 => extern struct {
        Low: ULONGLONG,
        High: LONGLONG,
    },
    else => @compileError("M128A only defined on x86_64"),
};

pub const XMM_SAVE_AREA32 = switch (native_arch) {
    .x86_64 => extern struct {
        ControlWord: WORD,
        StatusWord: WORD,
        TagWord: BYTE,
        Reserved1: BYTE,
        ErrorOpcode: WORD,
        ErrorOffset: DWORD,
        ErrorSelector: WORD,
        Reserved2: WORD,
        DataOffset: DWORD,
        DataSelector: WORD,
        Reserved3: WORD,
        MxCsr: DWORD,
        MxCsr_Mask: DWORD,
        FloatRegisters: [8]M128A,
        XmmRegisters: [16]M128A,
        Reserved4: [96]BYTE,
    },
    else => @compileError("XMM_SAVE_AREA32 only defined on x86_64"),
};

pub const NEON128 = switch (native_arch) {
    .thumb => extern struct {
        Low: ULONGLONG,
        High: LONGLONG,
    },
    .aarch64 => extern union {
        DUMMYSTRUCTNAME: extern struct {
            Low: ULONGLONG,
            High: LONGLONG,
        },
        D: [2]f64,
        S: [4]f32,
        H: [8]WORD,
        B: [16]BYTE,
    },
    else => @compileError("NEON128 only defined on aarch64"),
};

pub const CONTEXT = switch (native_arch) {
    .x86 => extern struct {
        ContextFlags: DWORD,
        Dr0: DWORD,
        Dr1: DWORD,
        Dr2: DWORD,
        Dr3: DWORD,
        Dr6: DWORD,
        Dr7: DWORD,
        FloatSave: FLOATING_SAVE_AREA,
        SegGs: DWORD,
        SegFs: DWORD,
        SegEs: DWORD,
        SegDs: DWORD,
        Edi: DWORD,
        Esi: DWORD,
        Ebx: DWORD,
        Edx: DWORD,
        Ecx: DWORD,
        Eax: DWORD,
        Ebp: DWORD,
        Eip: DWORD,
        SegCs: DWORD,
        EFlags: DWORD,
        Esp: DWORD,
        SegSs: DWORD,
        ExtendedRegisters: [512]BYTE,

        pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize } {
            return .{ .bp = ctx.Ebp, .ip = ctx.Eip, .sp = ctx.Esp };
        }
    },
    .x86_64 => extern struct {
        P1Home: DWORD64 align(16),
        P2Home: DWORD64,
        P3Home: DWORD64,
        P4Home: DWORD64,
        P5Home: DWORD64,
        P6Home: DWORD64,
        ContextFlags: DWORD,
        MxCsr: DWORD,
        SegCs: WORD,
        SegDs: WORD,
        SegEs: WORD,
        SegFs: WORD,
        SegGs: WORD,
        SegSs: WORD,
        EFlags: DWORD,
        Dr0: DWORD64,
        Dr1: DWORD64,
        Dr2: DWORD64,
        Dr3: DWORD64,
        Dr6: DWORD64,
        Dr7: DWORD64,
        Rax: DWORD64,
        Rcx: DWORD64,
        Rdx: DWORD64,
        Rbx: DWORD64,
        Rsp: DWORD64,
        Rbp: DWORD64,
        Rsi: DWORD64,
        Rdi: DWORD64,
        R8: DWORD64,
        R9: DWORD64,
        R10: DWORD64,
        R11: DWORD64,
        R12: DWORD64,
        R13: DWORD64,
        R14: DWORD64,
        R15: DWORD64,
        Rip: DWORD64,
        DUMMYUNIONNAME: extern union {
            FltSave: XMM_SAVE_AREA32,
            FloatSave: XMM_SAVE_AREA32,
            DUMMYSTRUCTNAME: extern struct {
                Header: [2]M128A,
                Legacy: [8]M128A,
                Xmm0: M128A,
                Xmm1: M128A,
                Xmm2: M128A,
                Xmm3: M128A,
                Xmm4: M128A,
                Xmm5: M128A,
                Xmm6: M128A,
                Xmm7: M128A,
                Xmm8: M128A,
                Xmm9: M128A,
                Xmm10: M128A,
                Xmm11: M128A,
                Xmm12: M128A,
                Xmm13: M128A,
                Xmm14: M128A,
                Xmm15: M128A,
            },
        },
        VectorRegister: [26]M128A,
        VectorControl: DWORD64,
        DebugControl: DWORD64,
        LastBranchToRip: DWORD64,
        LastBranchFromRip: DWORD64,
        LastExceptionToRip: DWORD64,
        LastExceptionFromRip: DWORD64,

        pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize } {
            return .{ .bp = ctx.Rbp, .ip = ctx.Rip, .sp = ctx.Rsp };
        }

        pub fn setIp(ctx: *CONTEXT, ip: usize) void {
            ctx.Rip = ip;
        }

        pub fn setSp(ctx: *CONTEXT, sp: usize) void {
            ctx.Rsp = sp;
        }
    },
    .thumb => extern struct {
        ContextFlags: ULONG,
        R0: ULONG,
        R1: ULONG,
        R2: ULONG,
        R3: ULONG,
        R4: ULONG,
        R5: ULONG,
        R6: ULONG,
        R7: ULONG,
        R8: ULONG,
        R9: ULONG,
        R10: ULONG,
        R11: ULONG,
        R12: ULONG,
        Sp: ULONG,
        Lr: ULONG,
        Pc: ULONG,
        Cpsr: ULONG,
        Fpcsr: ULONG,
        Padding: ULONG,
        DUMMYUNIONNAME: extern union {
            Q: [16]NEON128,
            D: [32]ULONGLONG,
            S: [32]ULONG,
        },
        Bvr: [8]ULONG,
        Bcr: [8]ULONG,
        Wvr: [1]ULONG,
        Wcr: [1]ULONG,
        Padding2: [2]ULONG,

        pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize } {
            return .{
                .bp = ctx.DUMMYUNIONNAME.S[11],
                .ip = ctx.Pc,
                .sp = ctx.Sp,
            };
        }

        pub fn setIp(ctx: *CONTEXT, ip: usize) void {
            ctx.Pc = ip;
        }

        pub fn setSp(ctx: *CONTEXT, sp: usize) void {
            ctx.Sp = sp;
        }
    },
    .aarch64 => extern struct {
        ContextFlags: ULONG align(16),
        Cpsr: ULONG,
        DUMMYUNIONNAME: extern union {
            DUMMYSTRUCTNAME: extern struct {
                X0: DWORD64,
                X1: DWORD64,
                X2: DWORD64,
                X3: DWORD64,
                X4: DWORD64,
                X5: DWORD64,
                X6: DWORD64,
                X7: DWORD64,
                X8: DWORD64,
                X9: DWORD64,
                X10: DWORD64,
                X11: DWORD64,
                X12: DWORD64,
                X13: DWORD64,
                X14: DWORD64,
                X15: DWORD64,
                X16: DWORD64,
                X17: DWORD64,
                X18: DWORD64,
                X19: DWORD64,
                X20: DWORD64,
                X21: DWORD64,
                X22: DWORD64,
                X23: DWORD64,
                X24: DWORD64,
                X25: DWORD64,
                X26: DWORD64,
                X27: DWORD64,
                X28: DWORD64,
                Fp: DWORD64,
                Lr: DWORD64,
            },
            X: [31]DWORD64,
        },
        Sp: DWORD64,
        Pc: DWORD64,
        V: [32]NEON128,
        Fpcr: DWORD,
        Fpsr: DWORD,
        Bcr: [8]DWORD,
        Bvr: [8]DWORD64,
        Wcr: [2]DWORD,
        Wvr: [2]DWORD64,

        pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize } {
            return .{
                .bp = ctx.DUMMYUNIONNAME.DUMMYSTRUCTNAME.Fp,
                .ip = ctx.Pc,
                .sp = ctx.Sp,
            };
        }

        pub fn setIp(ctx: *CONTEXT, ip: usize) void {
            ctx.Pc = ip;
        }

        pub fn setSp(ctx: *CONTEXT, sp: usize) void {
            ctx.Sp = sp;
        }
    },
    else => @compileError("CONTEXT is not defined for this architecture"),
};

pub const RUNTIME_FUNCTION = switch (native_arch) {
    .x86_64 => extern struct {
        BeginAddress: DWORD,
        EndAddress: DWORD,
        UnwindData: DWORD,
    },
    .thumb => extern struct {
        BeginAddress: DWORD,
        DUMMYUNIONNAME: extern union {
            UnwindData: DWORD,
            DUMMYSTRUCTNAME: packed struct(u32) {
                Flag: u2,
                FunctionLength: u11,
                Ret: u2,
                H: u1,
                Reg: u3,
                R: u1,
                L: u1,
                C: u1,
                StackAdjust: u10,
            },
        },
    },
    .aarch64 => extern struct {
        BeginAddress: DWORD,
        DUMMYUNIONNAME: extern union {
            UnwindData: DWORD,
            DUMMYSTRUCTNAME: packed struct(u32) {
                Flag: u2,
                FunctionLength: u11,
                RegF: u3,
                RegI: u4,
                H: u1,
                CR: u2,
                FrameSize: u9,
            },
        },
    },
    else => @compileError("RUNTIME_FUNCTION is not defined for this architecture"),
};

pub const KNONVOLATILE_CONTEXT_POINTERS = switch (native_arch) {
    .x86_64 => extern struct {
        FloatingContext: [16]?*M128A,
        IntegerContext: [16]?*ULONG64,
    },
    .thumb => extern struct {
        R4: ?*DWORD,
        R5: ?*DWORD,
        R6: ?*DWORD,
        R7: ?*DWORD,
        R8: ?*DWORD,
        R9: ?*DWORD,
        R10: ?*DWORD,
        R11: ?*DWORD,
        Lr: ?*DWORD,
        D8: ?*ULONGLONG,
        D9: ?*ULONGLONG,
        D10: ?*ULONGLONG,
        D11: ?*ULONGLONG,
        D12: ?*ULONGLONG,
        D13: ?*ULONGLONG,
        D14: ?*ULONGLONG,
        D15: ?*ULONGLONG,
    },
    .aarch64 => extern struct {
        X19: ?*DWORD64,
        X20: ?*DWORD64,
        X21: ?*DWORD64,
        X22: ?*DWORD64,
        X23: ?*DWORD64,
        X24: ?*DWORD64,
        X25: ?*DWORD64,
        X26: ?*DWORD64,
        X27: ?*DWORD64,
        X28: ?*DWORD64,
        Fp: ?*DWORD64,
        Lr: ?*DWORD64,
        D8: ?*DWORD64,
        D9: ?*DWORD64,
        D10: ?*DWORD64,
        D11: ?*DWORD64,
        D12: ?*DWORD64,
        D13: ?*DWORD64,
        D14: ?*DWORD64,
        D15: ?*DWORD64,
    },
    else => @compileError("KNONVOLATILE_CONTEXT_POINTERS is not defined for this architecture"),
};

pub const EXCEPTION_POINTERS = extern struct {
    ExceptionRecord: *EXCEPTION_RECORD,
    ContextRecord: *CONTEXT,
};

pub const VECTORED_EXCEPTION_HANDLER = *const fn (ExceptionInfo: *EXCEPTION_POINTERS) callconv(.winapi) c_long;

pub const EXCEPTION_DISPOSITION = i32;
pub const EXCEPTION_ROUTINE = *const fn (
    ExceptionRecord: ?*EXCEPTION_RECORD,
    EstablisherFrame: PVOID,
    ContextRecord: *CONTEXT,
    DispatcherContext: PVOID,
) callconv(.winapi) EXCEPTION_DISPOSITION;

pub const UNWIND_HISTORY_TABLE_SIZE = 12;
pub const UNWIND_HISTORY_TABLE_ENTRY = extern struct {
    ImageBase: ULONG64,
    FunctionEntry: *RUNTIME_FUNCTION,
};

pub const UNWIND_HISTORY_TABLE = extern struct {
    Count: ULONG,
    LocalHint: BYTE,
    GlobalHint: BYTE,
    Search: BYTE,
    Once: BYTE,
    LowAddress: ULONG64,
    HighAddress: ULONG64,
    Entry: [UNWIND_HISTORY_TABLE_SIZE]UNWIND_HISTORY_TABLE_ENTRY,
};

pub const UNW_FLAG_NHANDLER = 0x0;
pub const UNW_FLAG_EHANDLER = 0x1;
pub const UNW_FLAG_UHANDLER = 0x2;
pub const UNW_FLAG_CHAININFO = 0x4;

pub const ACTIVATION_CONTEXT_DATA = opaque {};
pub const ASSEMBLY_STORAGE_MAP = opaque {};
pub const FLS_CALLBACK_INFO = opaque {};
pub const RTL_BITMAP = opaque {};
pub const KAFFINITY = usize;
pub const KPRIORITY = i32;

pub const CLIENT_ID = extern struct {
    UniqueProcess: ?HANDLE,
    UniqueThread: ?HANDLE,
};

pub const TEB = extern struct {
    NtTib: NT_TIB,
    EnvironmentPointer: PVOID,
    ClientId: CLIENT_ID,
    ActiveRpcHandle: PVOID,
    ThreadLocalStoragePointer: PVOID,
    ProcessEnvironmentBlock: *PEB,
    LastErrorValue: Win32Error,
    Reserved2: [399 * @sizeOf(PVOID) - @sizeOf(ULONG)]u8,
    Reserved3: [1952]u8,
    TlsSlots: [64]PVOID,
    Reserved4: [8]u8,
    Reserved5: [26]PVOID,
    ReservedForOle: PVOID,
    Reserved6: [4]PVOID,
    TlsExpansionSlots: PVOID,
};

comptime {
    // XXX:没有此检查,无法在 16 位平台上使用 `std.Io.Writer`。没有此保护时,`std.mem.print` 会触发 `PEB.GdiHandleBuffer` 中的不可达路径。
    if (builtin.os.tag == .windows) {
        // 偏移取自 WinDbg 信息和 Geoff Chappell[1](安息)
        // [1]: https://www.geoffchappell.com/studies/windows/km/ntoskrnl/inc/api/pebteb/teb/index.htm
        assert(@offsetOf(TEB, "NtTib") == 0x00);
        if (@sizeOf(usize) == 4) {
            assert(@offsetOf(TEB, "EnvironmentPointer") == 0x1C);
            assert(@offsetOf(TEB, "ClientId") == 0x20);
            assert(@offsetOf(TEB, "ActiveRpcHandle") == 0x28);
            assert(@offsetOf(TEB, "ThreadLocalStoragePointer") == 0x2C);
            assert(@offsetOf(TEB, "ProcessEnvironmentBlock") == 0x30);
            assert(@offsetOf(TEB, "LastErrorValue") == 0x34);
            assert(@offsetOf(TEB, "TlsSlots") == 0xe10);
        } else if (@sizeOf(usize) == 8) {
            assert(@offsetOf(TEB, "EnvironmentPointer") == 0x38);
            assert(@offsetOf(TEB, "ClientId") == 0x40);
            assert(@offsetOf(TEB, "ActiveRpcHandle") == 0x50);
            assert(@offsetOf(TEB, "ThreadLocalStoragePointer") == 0x58);
            assert(@offsetOf(TEB, "ProcessEnvironmentBlock") == 0x60);
            assert(@offsetOf(TEB, "LastErrorValue") == 0x68);
            assert(@offsetOf(TEB, "TlsSlots") == 0x1480);
        }
    }
}

pub const EXCEPTION_REGISTRATION_RECORD = extern struct {
    Next: ?*EXCEPTION_REGISTRATION_RECORD,
    Handler: ?*EXCEPTION_DISPOSITION,
};

pub const NT_TIB = extern struct {
    ExceptionList: ?*EXCEPTION_REGISTRATION_RECORD,
    StackBase: PVOID,
    StackLimit: PVOID,
    SubSystemTib: PVOID,
    DUMMYUNIONNAME: extern union { FiberData: PVOID, Version: DWORD },
    ArbitraryUserPointer: PVOID,
    Self: ?*@This(),
};

/// 进程环境块
/// 微软对此的文档不完整,此处字段来自多种资料,包括:
///  - https://github.com/wine-mirror/wine/blob/1aff1e6a370ee8c0213a0fd4b220d121da8527aa/include/winternl.h#L269
///  - https://www.geoffchappell.com/studies/windows/win32/ntdll/structs/peb/index.htm
pub const PEB = extern struct {
    // 版本:全部
    InheritedAddressSpace: BOOLEAN,

    // 版本:3.51+
    ReadImageFileExecOptions: BOOLEAN,
    BeingDebugged: BOOLEAN,

    // 版本:5.2 及更高版本(此前为填充)
    BitField: UCHAR,

    // 版本:全部
    Mutant: HANDLE,
    ImageBaseAddress: HMODULE,
    Ldr: *PEB_LDR_DATA,
    ProcessParameters: *RTL_USER_PROCESS_PARAMETERS,
    SubSystemData: PVOID,
    ProcessHeap: ?*HEAP,

    // 版本:5.1 及更高版本
    FastPebLock: *RTL_CRITICAL_SECTION,

    // 版本:5.2+
    AtlThunkSListPtr: PVOID,
    IFEOKey: PVOID,

    // 版本:6.0+

    /// https://www.geoffchappell.com/studies/windows/win32/ntdll/structs/peb/crossprocessflags.htm
    CrossProcessFlags: ULONG,

    // 版本:6.0+
    union1: extern union {
        KernelCallbackTable: PVOID,
        UserSharedInfoPtr: PVOID,
    },

    // 版本:5.1 及更高版本
    SystemReserved: ULONG,

    // 版本:5.1、(不含 5.2、6.0)、6.1+
    AtlThunkSListPtr32: ULONG,

    // 版本:6.1 及更高版本
    ApiSetMap: PVOID,

    // 版本:全部
    TlsExpansionCounter: ULONG,
    // 注意:64 位环境中此处有填充
    TlsBitmap: *RTL_BITMAP,
    TlsBitmapBits: [2]ULONG,
    /// 与 CSR 服务器共享的内存区域在本方的基址。
    ReadOnlySharedMemoryBase: PVOID,

    // 版本:1703 及更高版本
    SharedData: PVOID,

    // 版本:全部
    ReadOnlyStaticServerData: *UnknownStaticServerDataIndirection,
    AnsiCodePageData: PVOID,
    OemCodePageData: PVOID,
    UnicodeCaseTableData: PVOID,

    // 版本:3.51+
    NumberOfProcessors: ULONG,
    NtGlobalFlag: ULONG,

    // 版本:全部
    CriticalSectionTimeout: LARGE_INTEGER,

    // 原始 PEB 大小的末尾

    // 在 3.51 中追加的字段:
    HeapSegmentReserve: ULONG_PTR,
    HeapSegmentCommit: ULONG_PTR,
    HeapDeCommitTotalFreeThreshold: ULONG_PTR,
    HeapDeCommitFreeBlockThreshold: ULONG_PTR,
    NumberOfHeaps: ULONG,
    MaximumNumberOfHeaps: ULONG,
    ProcessHeaps: *PVOID,

    // 在 4.0 中追加的字段:
    GdiSharedHandleTable: PVOID,
    ProcessStarterHelper: PVOID,
    GdiDCAttributeList: ULONG,
    // 注意:64 位环境中此处有填充
    LoaderLock: *RTL_CRITICAL_SECTION,
    OSMajorVersion: ULONG,
    OSMinorVersion: ULONG,
    OSBuildNumber: USHORT,
    OSCSDVersion: USHORT,
    OSPlatformId: ULONG,
    ImageSubSystem: ULONG,
    ImageSubSystemMajorVersion: ULONG,
    ImageSubSystemMinorVersion: ULONG,
    // 注意:64 位环境中此处有填充
    ActiveProcessAffinityMask: KAFFINITY,
    GdiHandleBuffer: [
        switch (@sizeOf(usize)) {
            4 => 0x22,
            8 => 0x3C,
            else => unreachable,
        }
    ]ULONG,

    // 在 5.0(Windows 2000)中追加的字段:
    PostProcessInitRoutine: PVOID,
    TlsExpansionBitmap: *RTL_BITMAP,
    TlsExpansionBitmapBits: [32]ULONG,
    SessionId: ULONG,
    // 注意:64 位平台上此处有填充。
    // 版本:5.1+
    AppCompatFlags: ULARGE_INTEGER,
    AppCompatFlagsUser: ULARGE_INTEGER,
    ShimData: PVOID,
    // 版本:5.0+
    AppCompatInfo: PVOID,
    CSDVersion: UNICODE_STRING,

    // 在 5.1(Windows XP)中追加的字段:
    ActivationContextData: *const ACTIVATION_CONTEXT_DATA,
    ProcessAssemblyStorageMap: *ASSEMBLY_STORAGE_MAP,
    SystemDefaultActivationData: *const ACTIVATION_CONTEXT_DATA,
    SystemAssemblyStorageMap: *ASSEMBLY_STORAGE_MAP,
    MinimumStackCommit: ULONG_PTR,

    // 在 5.2(Windows Server 2003)中追加的字段:
    FlsCallback: *FLS_CALLBACK_INFO,
    FlsListHead: LIST_ENTRY,
    FlsBitmap: *RTL_BITMAP,
    FlsBitmapBits: [4]ULONG,
    FlsHighIndex: ULONG,

    // 在 6.0(Windows Vista)中追加的字段:
    WerRegistrationData: PVOID,
    WerShipAssertPtr: PVOID,

    // 在 6.1(Windows 7)中追加的字段:
    pUnused: PVOID, // 以前为 pContextData
    pImageHeaderHash: PVOID,

    /// TODO: https://www.geoffchappell.com/studies/windows/win32/ntdll/structs/peb/tracingflags.htm
    TracingFlags: ULONG,

    // 在 6.2(Windows 8)中追加的字段:
    /// 与 CSR 服务器共享的内存区域在 CSRSS 地址空间中的基址。
    CsrServerReadOnlySharedMemoryBase: ULONGLONG,

    // 1511 中追加的字段:
    TppWorkerpListLock: ULONG,
    TppWorkerpList: LIST_ENTRY,
    WaitOnAddressHashTable: [0x80]PVOID,

    // 在 1709 中追加的字段:
    TelemetryCoverageHeader: PVOID,
    CloudFileFlags: ULONG,

    /// 此结构体的具体细节未知,但实验和对 kernelbase.dll 的逆向分析
    /// 确认偏移 8 处存在一个字段。
    const UnknownStaticServerDataIndirection = extern struct {
        unknown: u64,
        /// 位于 CSRSS 地址空间。
        base_static_server_data_addr: u64,
    };
};

/// `PEB_LDR_DATA` 结构体是进程已加载模块的主要记录。
/// 它本质上是三个双链表的表头,链表元素为 `LDR.DATA_TABLE_ENTRY` 结构体,每个表示一个已加载模块。
///
/// 微软对此的文档不完整,这里的字段取自多种资料,包括:
///  - https://www.geoffchappell.com/studies/windows/win32/ntdll/structs/peb_ldr_data.htm
pub const PEB_LDR_DATA = extern struct {
    // 版本:3.51 及更高版本
    /// 结构体的字节大小
    Length: ULONG,

    /// 若结构已准备好,则为 TRUE。
    Initialized: BOOLEAN,

    SsHandle: PVOID,
    InLoadOrderModuleList: LIST_ENTRY,
    InMemoryOrderModuleList: LIST_ENTRY,
    InInitializationOrderModuleList: LIST_ENTRY,

    // 版本:5.1 及更高版本

    /// 尚不清楚此字段在 Windows 8 及以上版本中的用途。
    EntryInProgress: PVOID,

    // 版本:Windows Vista SP1(6.0)及更高版本
    ShutdownInProgress: BOOLEAN,

    /// 虽然 ShutdownThreadId 声明为 HANDLE,
    /// 但顾名思义,它实际上是线程标识符。
    /// 它来自请求终止进程的线程的
    /// TEB 内 CLIENT_ID 的 UniqueThread 成员。
    ShutdownThreadId: HANDLE,
};

pub const LDR = struct {
    /// 微软对此的文档不完整,此处字段取自多个资料,包括:
    ///  - https://docs.microsoft.com/en-us/windows/win32/api/winternl/ns-winternl-peb_ldr_data
    ///  - https://www.geoffchappell.com/studies/windows/km/ntoskrnl/inc/api/ntldr/ldr_data_table_entry.htm
    pub const DATA_TABLE_ENTRY = extern struct {
        InLoadOrderLinks: LIST_ENTRY,
        InMemoryOrderLinks: LIST_ENTRY,
        InInitializationOrderLinks: LIST_ENTRY,
        DllBase: PVOID,
        EntryPoint: PVOID,
        SizeOfImage: ULONG,
        FullDllName: UNICODE_STRING,
        BaseDllName: UNICODE_STRING,
        Reserved5: [3]PVOID,
        DUMMYUNIONNAME: extern union {
            CheckSum: ULONG,
            Reserved6: PVOID,
        },
        TimeDateStamp: ULONG,
    };

    pub const DLL_NOTIFICATION = struct {
        pub const REASON = enum(ULONG) { LOADED = 1, UNLOADED = 2 };

        pub const DATA = extern union {
            Loaded: LOADED,
            Unloaded: UNLOADED,

            pub const LOADED = extern struct {
                Flags: REGISTER,
                FullDllName: *const UNICODE_STRING,
                BaseDllName: *const UNICODE_STRING,
                DllBase: PVOID,
                SizeOfImage: ULONG,
            };

            pub const UNLOADED = extern struct {
                Flags: REGISTER,
                FullDllName: *const UNICODE_STRING,
                BaseDllName: *const UNICODE_STRING,
                DllBase: PVOID,
                SizeOfImage: ULONG,
            };
        };

        pub const COOKIE = *opaque {};

        pub const FUNCTION = fn (
            NotificationReason: REASON,
            NotificationData: *const DATA,
            Context: ?PVOID,
        ) callconv(.winapi) void;

        pub const REGISTER = packed struct(ULONG) {
            Reserved0: u32 = 0,
        };
    };

    pub const GET_DLL_HANDLE_EX = packed struct(ULONG) {
        UNCHANGED_REFCOUNT: bool = false,
        PIN: bool = false,
        Reserved2: u30 = 0,
    };

    pub const GET_PROCEDURE_ADDRESS = packed struct(ULONG) {
        DONT_RECORD_FORWARDER: bool = false,
        Reserved1: u31 = 0,
    };

    pub const LOAD = packed struct(ULONG) {
        DONT_RESOLVE_DLL_REFERENCES: bool = false,
        LIBRARY_AS_DATAFILE: bool = false,
        PACKAGED_LIBRARY: bool = false,
        WITH_ALTERED_SEARCH_PATH: bool = false,
        IGNORE_CODE_AUTHZ_LEVEL: bool = false,
        LIBRARY_AS_IMAGE_RESOURCE: bool = false,
        LIBRARY_AS_DATAFILE_EXCLUSIVE: bool = false,
        LIBRARY_REQUERE_SIGNED_TARGET: bool = false,
        LIBRARY_SEARCH_DLL_LOAD_DIR: bool = false,
        LIBRARY_SEARCH_USER_DIRS: bool = false,
        LIBRARY_SEARCH_SYSTEM32: bool = false,
        LIBRARY_SEARCH_DEFAULT_DIRS: bool = false,
    };
};

pub const RTL_USER_PROCESS_PARAMETERS = extern struct {
    AllocationSize: ULONG,
    Size: ULONG,
    Flags: ULONG,
    DebugFlags: ULONG,
    ConsoleHandle: HANDLE,
    ConsoleFlags: ULONG,
    hStdInput: HANDLE,
    hStdOutput: HANDLE,
    hStdError: HANDLE,
    CurrentDirectory: CURDIR,
    DllPath: UNICODE_STRING,
    ImagePathName: UNICODE_STRING,
    CommandLine: UNICODE_STRING,
    /// 指向以 NUL 终止的序列,其中每项均为以 NUL 终止、
    /// 采用 WTF-16 LE 编码的 `name=value` 序列。
    /// 使用字符串字面量语法的示例:
    /// `"NAME=value\x00foo=bar\x00\x00"`
    Environment: [*:0]WCHAR,
    dwX: ULONG,
    dwY: ULONG,
    dwXSize: ULONG,
    dwYSize: ULONG,
    dwXCountChars: ULONG,
    dwYCountChars: ULONG,
    dwFillAttribute: ULONG,
    dwFlags: ULONG,
    dwShowWindow: ULONG,
    WindowTitle: UNICODE_STRING,
    Desktop: UNICODE_STRING,
    ShellInfo: UNICODE_STRING,
    RuntimeInfo: UNICODE_STRING,
    DLCurrentDirectory: [0x20]RTL_DRIVE_LETTER_CURDIR,
};

pub const RTL_DRIVE_LETTER_CURDIR = extern struct {
    Flags: c_ushort,
    Length: c_ushort,
    TimeStamp: ULONG,
    DosPath: UNICODE_STRING,
};

pub const PPS_POST_PROCESS_INIT_ROUTINE = ?*const fn () callconv(.winapi) void;

pub const FILE_DIRECTORY_INFORMATION = extern struct {
    NextEntryOffset: ULONG,
    FileIndex: ULONG,
    CreationTime: LARGE_INTEGER,
    LastAccessTime: LARGE_INTEGER,
    LastWriteTime: LARGE_INTEGER,
    ChangeTime: LARGE_INTEGER,
    EndOfFile: LARGE_INTEGER,
    AllocationSize: LARGE_INTEGER,
    FileAttributes: FILE.ATTRIBUTE,
    FileNameLength: ULONG,
    FileName: [1]WCHAR,
};

pub const FILE_BOTH_DIR_INFORMATION = extern struct {
    NextEntryOffset: ULONG,
    FileIndex: ULONG,
    CreationTime: LARGE_INTEGER,
    LastAccessTime: LARGE_INTEGER,
    LastWriteTime: LARGE_INTEGER,
    ChangeTime: LARGE_INTEGER,
    EndOfFile: LARGE_INTEGER,
    AllocationSize: LARGE_INTEGER,
    FileAttributes: FILE.ATTRIBUTE,
    FileNameLength: ULONG,
    EaSize: ULONG,
    ShortNameLength: CHAR,
    ShortName: [12]WCHAR,
    FileName: [1]WCHAR,
};
pub const FILE_BOTH_DIRECTORY_INFORMATION = FILE_BOTH_DIR_INFORMATION;

/// 用于遍历 FILE_*_INFORMATION 结构体字节缓冲区的辅助函数(如 NtQueryDirectoryFile 调用的结果)。
///
pub fn FileInformationIterator(comptime FileInformationType: type) type {
    return struct {
        byte_offset: usize = 0,
        buf: []u8 align(@alignOf(FileInformationType)),

        pub fn next(self: *@This()) ?*FileInformationType {
            if (self.byte_offset >= self.buf.len) return null;
            const cur: *FileInformationType = @ptrCast(@alignCast(&self.buf[self.byte_offset]));
            if (cur.NextEntryOffset == 0) {
                self.byte_offset = self.buf.len;
            } else {
                self.byte_offset += cur.NextEntryOffset;
            }
            return cur;
        }
    };
}

pub const IO_APC_ROUTINE = fn (?*anyopaque, *IO_STATUS_BLOCK, ULONG) callconv(.winapi) void;

pub const CURDIR = extern struct {
    DosPath: UNICODE_STRING,
    Handle: HANDLE,
};

pub const DUPLICATE_SAME_ACCESS = 2;

pub const MODULEINFO = extern struct {
    lpBaseOfDll: LPVOID,
    SizeOfImage: DWORD,
    EntryPoint: LPVOID,
};

pub const OSVERSIONINFOW = extern struct {
    dwOSVersionInfoSize: ULONG,
    dwMajorVersion: ULONG,
    dwMinorVersion: ULONG,
    dwBuildNumber: ULONG,
    dwPlatformId: ULONG,
    szCSDVersion: [128]WCHAR,
};
pub const RTL_OSVERSIONINFOW = OSVERSIONINFOW;

pub const REPARSE_DATA_BUFFER = extern struct {
    ReparseTag: IO_REPARSE_TAG,
    ReparseDataLength: USHORT,
    Reserved: USHORT,
    DataBuffer: [1]UCHAR,
};
pub const SYMBOLIC_LINK_REPARSE_BUFFER = extern struct {
    SubstituteNameOffset: USHORT,
    SubstituteNameLength: USHORT,
    PrintNameOffset: USHORT,
    PrintNameLength: USHORT,
    Flags: ULONG,
    PathBuffer: [1]WCHAR,
};
pub const MOUNT_POINT_REPARSE_BUFFER = extern struct {
    SubstituteNameOffset: USHORT,
    SubstituteNameLength: USHORT,
    PrintNameOffset: USHORT,
    PrintNameLength: USHORT,
    PathBuffer: [1]WCHAR,
};
pub const SYMLINK_FLAG_RELATIVE: ULONG = 0x1;

pub const SYMBOLIC_LINK_FLAG_DIRECTORY: DWORD = 0x1;
pub const SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE: DWORD = 0x2;

pub const MOUNTMGR_MOUNT_POINT = extern struct {
    SymbolicLinkNameOffset: ULONG,
    SymbolicLinkNameLength: USHORT,
    Reserved1: USHORT,
    UniqueIdOffset: ULONG,
    UniqueIdLength: USHORT,
    Reserved2: USHORT,
    DeviceNameOffset: ULONG,
    DeviceNameLength: USHORT,
    Reserved3: USHORT,
};
pub const MOUNTMGR_MOUNT_POINTS = extern struct {
    Size: ULONG,
    NumberOfMountPoints: ULONG,
    MountPoints: [1]MOUNTMGR_MOUNT_POINT,
};

pub const MOUNTMGR_TARGET_NAME = extern struct {
    DeviceNameLength: USHORT,
    DeviceName: [1]WCHAR,
};
pub const MOUNTMGR_VOLUME_PATHS = extern struct {
    MultiSzLength: ULONG,
    MultiSz: [1]WCHAR,
};

pub const SRWLOCK_INIT = SRWLOCK{};
pub const SRWLOCK = extern struct {
    Ptr: ?PVOID = null,
};

pub const CONDITION_VARIABLE_INIT = CONDITION_VARIABLE{};
pub const CONDITION_VARIABLE = extern struct {
    Ptr: ?PVOID = null,
};

/// 处理器特性枚举。
pub const PF = enum(DWORD) {
    /// 在 Pentium 上,极少数情况下会发生浮点精度错误。
    FLOATING_POINT_PRECISION_ERRATA = 0,

    /// 使用软件模拟器模拟浮点运算。
    /// 若浮点运算被模拟,则此函数返回非零值;否则返回零。
    FLOATING_POINT_EMULATED = 1,

    /// 支持原子比较并交换操作(cmpxchg)。
    COMPARE_EXCHANGE_DOUBLE = 2,

    /// MMX 指令集可用。
    MMX_INSTRUCTIONS_AVAILABLE = 3,

    PPC_MOVEMEM_64BIT_OK = 4,
    ALPHA_BYTE_INSTRUCTIONS = 5,

    /// 可使用 SSE 指令集。
    XMMI_INSTRUCTIONS_AVAILABLE = 6,

    /// 3D-Now 指令可用。
    @"3DNOW_INSTRUCTIONS_AVAILABLE" = 7,

    /// RDTSC 指令可用。
    RDTSC_INSTRUCTION_AVAILABLE = 8,

    /// 处理器已启用 PAE。
    PAE_ENABLED = 9,

    /// SSE2 指令集可用。
    XMMI64_INSTRUCTIONS_AVAILABLE = 10,

    SSE_DAZ_MODE_AVAILABLE = 11,

    /// 已启用数据执行保护。
    NX_ENABLED = 12,

    /// 可使用 SSE3 指令集。
    SSE3_INSTRUCTIONS_AVAILABLE = 13,

    /// 支持原子 128 位比较并交换操作(cmpxchg16b)。
    COMPARE_EXCHANGE128 = 14,

    /// 支持原子的比较 64 位并交换 128 位操作(cmp8xchg16)。
    COMPARE64_EXCHANGE128 = 15,

    /// 已启用处理器通道。
    CHANNELS_ENABLED = 16,

    /// 处理器实现 XSAVI 和 XRSTOR 指令。
    XSAVE_ENABLED = 17,

    /// 存在 VFP/Neon:32 x 64 位寄存器组。
    /// 此标志与 PF_ARM_VFP_EXTENDED_REGISTERS 含义相同。
    ARM_VFP_32_REGISTERS_AVAILABLE = 18,

    /// 此 ARM 处理器实现 ARM v8 NEON 指令集。
    ARM_NEON_INSTRUCTIONS_AVAILABLE = 19,

    /// 硬件支持第二级地址转换。
    SECOND_LEVEL_ADDRESS_TRANSLATION = 20,

    /// 固件中已启用虚拟化,且操作系统已提供该功能。
    VIRT_FIRMWARE_ENABLED = 21,

    /// RDFSBASE、RDGSBASE、WRFSBASE 和 WRGSBASE 指令可用。
    RDWRFSGBASE_AVAILABLE = 22,

    /// _fastfail() 可用。
    FASTFAIL_AVAILABLE = 23,

    /// 除法指令可用。
    ARM_DIVIDE_INSTRUCTION_AVAILABLE = 24,

    /// 支持 64 位加载及存储原子指令。
    ARM_64BIT_LOADSTORE_ATOMIC = 25,

    /// 外部缓存可用。
    ARM_EXTERNAL_CACHE_AVAILABLE = 26,

    /// 支持浮点乘加指令。
    ARM_FMAC_INSTRUCTIONS_AVAILABLE = 27,

    RDRAND_INSTRUCTION_AVAILABLE = 28,

    /// 此 ARM 处理器实现 ARM v8 指令集。
    ARM_V8_INSTRUCTIONS_AVAILABLE = 29,

    /// 此 ARM 处理器实现 ARM v8 额外密码学指令,即 AES、SHA1 和 SHA2。
    ARM_V8_CRYPTO_INSTRUCTIONS_AVAILABLE = 30,

    /// 此 ARM 处理器实现 ARM v8 额外的 CRC32 指令。
    ARM_V8_CRC32_INSTRUCTIONS_AVAILABLE = 31,

    RDTSCP_INSTRUCTION_AVAILABLE = 32,
    RDPID_INSTRUCTION_AVAILABLE = 33,

    /// 此 ARM 处理器实现 ARM v8.1 原子指令(例如 CAS、SWP)。
    ARM_V81_ATOMIC_INSTRUCTIONS_AVAILABLE = 34,

    MONITORX_INSTRUCTION_AVAILABLE = 35,

    /// SSSE3 指令集可用。
    SSSE3_INSTRUCTIONS_AVAILABLE = 36,

    /// SSE4_1 指令集可用。
    SSE4_1_INSTRUCTIONS_AVAILABLE = 37,

    /// 可使用 SSE4_2 指令集。
    SSE4_2_INSTRUCTIONS_AVAILABLE = 38,

    /// AVX 指令集可用。
    AVX_INSTRUCTIONS_AVAILABLE = 39,

    /// AVX2 指令集可用。
    AVX2_INSTRUCTIONS_AVAILABLE = 40,

    /// AVX512F 指令集可用。
    AVX512F_INSTRUCTIONS_AVAILABLE = 41,

    ERMS_AVAILABLE = 42,

    /// 此 ARM 处理器实现 ARM v8.2 点积(DP)指令。
    ARM_V82_DP_INSTRUCTIONS_AVAILABLE = 43,

    /// 此 ARM 处理器实现 ARM v8.3 JavaScript 转换(JSCVT)指令。
    ARM_V83_JSCVT_INSTRUCTIONS_AVAILABLE = 44,

    /// 此 Arm 处理器实现 Arm v8.3 LRCPC 指令,例如 LDAPR。注意,某些 Arm v8.2 CPU 也可能选择性支持 LRCPC 指令。
    ARM_V83_LRCPC_INSTRUCTIONS_AVAILABLE = 45,

    /// 此 Arm 处理器实现 SVE(可伸缩向量扩展)指令(FEAT_SVE)。
    ARM_SVE_INSTRUCTIONS_AVAILABLE = 46,

    /// 此 Arm 处理器实现 SVE2 指令(FEAT_SVE2)。
    ARM_SVE2_INSTRUCTIONS_AVAILABLE = 47,

    /// 此 Arm 处理器实现 SVE2.1 指令(FEAT_SVE2p1)。
    ARM_SVE2_1_INSTRUCTIONS_AVAILABLE = 48,

    /// 此 Arm 处理器实现 SVE AES 指令(FEAT_SVE_AES)。
    ARM_SVE_AES_INSTRUCTIONS_AVAILABLE = 49,

    /// 此 Arm 处理器实现 SVE 128 位多项式长乘法指令(FEAT_SVE_PMULL128)。
    ARM_SVE_PMULL128_INSTRUCTIONS_AVAILABLE = 50,

    /// 此 Arm 处理器实现 SVE 位排列指令(FEAT_SVE_BitPerm)。
    ARM_SVE_BITPERM_INSTRUCTIONS_AVAILABLE = 51,

    /// 此 Arm 处理器实现 SVE BF16(BFloat16)指令(FEAT_BF16)。
    ARM_SVE_BF16_INSTRUCTIONS_AVAILABLE = 52,

    /// 此 Arm 处理器实现 SVE EBF16(扩展 BFloat16)指令(FEAT_EBF16)。
    ARM_SVE_EBF16_INSTRUCTIONS_AVAILABLE = 53,

    /// 此 Arm 处理器实现 SVE B16B16 指令(FEAT_SVE_B16B16)。
    ARM_SVE_B16B16_INSTRUCTIONS_AVAILABLE = 54,

    /// 此 Arm 处理器实现 SVE SHA-3 密码学指令(FEAT_SVE_SHA3)。
    ARM_SVE_SHA3_INSTRUCTIONS_AVAILABLE = 55,

    /// 此 Arm 处理器实现 SVE SM4 加密指令(FEAT_SVE_SM4)。
    ARM_SVE_SM4_INSTRUCTIONS_AVAILABLE = 56,

    /// 此 Arm 处理器实现 SVE I8MM(Int8 矩阵乘法)指令(FEAT_I8MM)。
    ARM_SVE_I8MM_INSTRUCTIONS_AVAILABLE = 57,

    /// 此 Arm 处理器实现 SVE F32MM(FP32 矩阵乘法)指令(FEAT_F32MM)。
    ARM_SVE_F32MM_INSTRUCTIONS_AVAILABLE = 58,

    /// 此 Arm 处理器实现 SVE F64MM(FP64 矩阵乘法)指令(FEAT_F64MM)。
    ARM_SVE_F64MM_INSTRUCTIONS_AVAILABLE = 59,

    /// 此 x64 处理器实现 BMI2 指令集。
    BMI2_INSTRUCTIONS_AVAILABLE = 60,

    /// 此 x64 处理器实现 MOVDIR64B 指令。
    MOVDIR64B_INSTRUCTION_AVAILABLE = 61,

    /// 此 Arm 处理器实现 LSE2 原子指令(FEAT_LSE2)。
    ARM_LSE2_AVAILABLE = 62,

    /// 此 Arm 处理器实现 SHA-3 密码指令(FEAT_SHA3)。
    ARM_SHA3_INSTRUCTIONS_AVAILABLE = 64,

    /// 此 Arm 处理器实现 SHA-512 密码学指令(FEAT_SHA512)。
    ARM_SHA512_INSTRUCTIONS_AVAILABLE = 65,

    /// 此 Arm 处理器实现 I8MM(Int8 矩阵乘法)NEON 指令(FEAT_I8MM)。
    ARM_V82_I8MM_INSTRUCTIONS_AVAILABLE = 66,

    /// 此 Arm 处理器实现 FP16(半精度浮点)NEON 指令(FEAT_FP16)。
    ARM_V82_FP16_INSTRUCTIONS_AVAILABLE = 67,

    /// 此 Arm 处理器实现 BF16(BFloat16)NEON 指令(FEAT_BF16)。
    ARM_V86_BF16_INSTRUCTIONS_AVAILABLE = 68,

    /// 此 Arm 处理器实现 EBF16(扩展 BFloat16)NEON 指令(FEAT_EBF16)。
    ARM_V86_EBF16_INSTRUCTIONS_AVAILABLE = 69,

    /// 此 Arm 处理器实现 SME(可扩展矩阵扩展)指令(FEAT_SME)。
    ARM_SME_INSTRUCTIONS_AVAILABLE = 70,

    /// 此 Arm 处理器实现 SME2 指令(FEAT_SME2)。
    ARM_SME2_INSTRUCTIONS_AVAILABLE = 71,

    /// 此 Arm 处理器实现 SME2.1 指令(FEAT_SME2p1)。
    ARM_SME2_1_INSTRUCTIONS_AVAILABLE = 72,

    /// 此 Arm 处理器实现 SME2.2 指令(FEAT_SME2p2)。
    ARM_SME2_2_INSTRUCTIONS_AVAILABLE = 73,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE AES 指令(FEAT_SSVE_AES)。
    ARM_SME_AES_INSTRUCTIONS_AVAILABLE = 74,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE 位排列指令(FEAT_SSVE_BitPerm)。
    ARM_SME_SBITPERM_INSTRUCTIONS_AVAILABLE = 75,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE FMMLA(扩宽、四路、FP8 转 FP16)指令(FEAT_SSVE_F8F16MM)。
    ARM_SME_SF8MM4_INSTRUCTIONS_AVAILABLE = 76,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE FMMLA 指令,即扩宽、8 路、FP8 到 FP32 的运算(FEAT_SSVE_F8F32MM)。
    ARM_SME_SF8MM8_INSTRUCTIONS_AVAILABLE = 77,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8DOT2 指令(FEAT_SSVE_FP8DOT2)。
    ARM_SME_SF8DP2_INSTRUCTIONS_AVAILABLE = 78,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8DOT4 指令(FEAT_SSVE_FP8DOT4)。
    ARM_SME_SF8DP4_INSTRUCTIONS_AVAILABLE = 79,

    /// 此 Arm 处理器在流式 SVE 模式下实现 SVE2 FP8FMA 指令(FEAT_SSVE_FP8FMA)。
    ARM_SME_SF8FMA_INSTRUCTIONS_AVAILABLE = 80,

    /// 此 Arm 处理器实现 SME F8F32 指令(FEAT_SME_F8F32)。
    ARM_SME_F8F32_INSTRUCTIONS_AVAILABLE = 81,

    /// 此 Arm 处理器实现 SME F8F16 指令(FEAT_SME_F8F16)。
    ARM_SME_F8F16_INSTRUCTIONS_AVAILABLE = 82,

    /// 此 Arm 处理器实现 SME F16F16 指令(FEAT_SME_F16F16)。
    ARM_SME_F16F16_INSTRUCTIONS_AVAILABLE = 83,

    /// 此 Arm 处理器实现 SME B16B16 指令(FEAT_SME_B16B16)。
    ARM_SME_B16B16_INSTRUCTIONS_AVAILABLE = 84,

    /// 此 Arm 处理器实现 SME F64F64 指令(FEAT_SME_F64F64)。
    ARM_SME_F64F64_INSTRUCTIONS_AVAILABLE = 85,

    /// 此 Arm 处理器实现 SME I16I64 指令(FEAT_SME_I16I64)。
    ARM_SME_I16I64_INSTRUCTIONS_AVAILABLE = 86,

    /// 此 Arm 处理器实现 SME LUTv2 指令(FEAT_SME_LUTv2)。
    ARM_SME_LUTv2_INSTRUCTIONS_AVAILABLE = 87,

    /// 此 Arm 处理器实现 SME FA64(流式 SVE 模式下的完整 AArch64 指令集)(FEAT_SME_FA64)。
    ARM_SME_FA64_INSTRUCTIONS_AVAILABLE = 88,

    /// 此 x64 处理器实现了 UMONITOR 指令。
    UMONITOR_INSTRUCTION_AVAILABLE = 89,
};

pub const MAX_WOW64_SHARED_ENTRIES = 16;
pub const PROCESSOR_FEATURE_MAX = 64;
pub const MAXIMUM_XSTATE_FEATURES = 64;

pub const KSYSTEM_TIME = extern struct {
    LowPart: ULONG,
    High1Time: LONG,
    High2Time: LONG,
};

pub const NT_PRODUCT_TYPE = enum(INT) {
    NtProductWinNt = 1,
    NtProductLanManNt,
    NtProductServer,
};

pub const ALTERNATIVE_ARCHITECTURE_TYPE = enum(INT) {
    StandardDesign,
    NEC98x86,
    EndAlternatives,
};

pub const XSTATE_FEATURE = extern struct {
    Offset: ULONG,
    Size: ULONG,
};

pub const XSTATE_CONFIGURATION = extern struct {
    EnabledFeatures: ULONG64,
    Size: ULONG,
    OptimizedSave: ULONG,
    Features: [MAXIMUM_XSTATE_FEATURES]XSTATE_FEATURE,
};

/// 共享内核用户数据
pub const KUSER_SHARED_DATA = extern struct {
    TickCountLowDeprecated: ULONG,
    TickCountMultiplier: ULONG,
    InterruptTime: KSYSTEM_TIME,
    SystemTime: KSYSTEM_TIME,
    TimeZoneBias: KSYSTEM_TIME,
    ImageNumberLow: USHORT,
    ImageNumberHigh: USHORT,
    NtSystemRoot: [260]WCHAR,
    MaxStackTraceDepth: ULONG,
    CryptoExponent: ULONG,
    TimeZoneId: ULONG,
    LargePageMinimum: ULONG,
    AitSamplingValue: ULONG,
    AppCompatFlag: ULONG,
    RNGSeedVersion: ULONGLONG,
    GlobalValidationRunlevel: ULONG,
    TimeZoneBiasStamp: LONG,
    NtBuildNumber: ULONG,
    NtProductType: NT_PRODUCT_TYPE,
    ProductTypeIsValid: BOOLEAN,
    Reserved0: [1]BOOLEAN,
    NativeProcessorArchitecture: USHORT,
    NtMajorVersion: ULONG,
    NtMinorVersion: ULONG,
    ProcessorFeatures: [PROCESSOR_FEATURE_MAX]BOOLEAN,
    Reserved1: ULONG,
    Reserved3: ULONG,
    TimeSlip: ULONG,
    AlternativeArchitecture: ALTERNATIVE_ARCHITECTURE_TYPE,
    BootId: ULONG,
    SystemExpirationDate: LARGE_INTEGER,
    SuiteMaskY: ULONG,
    KdDebuggerEnabled: BOOLEAN,
    DummyUnion1: extern union {
        MitigationPolicies: UCHAR,
        Alt: packed struct(u8) {
            NXSupportPolicy: u2,
            SEHValidationPolicy: u2,
            CurDirDevicesSkippedForDlls: u2,
            Reserved: u2,
        },
    },
    CyclesPerYield: USHORT,
    ActiveConsoleId: ULONG,
    DismountCount: ULONG,
    ComPlusPackage: ULONG,
    LastSystemRITEventTickCount: ULONG,
    NumberOfPhysicalPages: ULONG,
    SafeBootMode: BOOLEAN,
    DummyUnion2: extern union {
        VirtualizationFlags: UCHAR,
        Alt: packed struct(u8) {
            ArchStartedInEl2: u1,
            QcSlIsSupported: u1,
            SpareBits: u6,
        },
    },
    Reserved12: [2]UCHAR,
    DummyUnion3: extern union {
        SharedDataFlags: ULONG,
        Alt: packed struct(u32) {
            DbgErrorPortPresent: u1,
            DbgElevationEnabled: u1,
            DbgVirtEnabled: u1,
            DbgInstallerDetectEnabled: u1,
            DbgLkgEnabled: u1,
            DbgDynProcessorEnabled: u1,
            DbgConsoleBrokerEnabled: u1,
            DbgSecureBootEnabled: u1,
            DbgMultiSessionSku: u1,
            DbgMultiUsersInSessionSku: u1,
            DbgStateSeparationEnabled: u1,
            SpareBits: u21,
        },
    },
    DataFlagsPad: [1]ULONG,
    TestRetInstruction: ULONGLONG,
    QpcFrequency: LONGLONG,
    SystemCall: ULONG,
    Reserved2: ULONG,
    SystemCallPad: [2]ULONGLONG,
    DummyUnion4: extern union {
        TickCount: KSYSTEM_TIME,
        TickCountQuad: ULONG64,
        Alt: extern struct {
            ReservedTickCountOverlay: [3]ULONG,
            TickCountPad: [1]ULONG,
        },
    },
    Cookie: ULONG,
    CookiePad: [1]ULONG,
    ConsoleSessionForegroundProcessId: LONGLONG,
    TimeUpdateLock: ULONGLONG,
    BaselineSystemTimeQpc: ULONGLONG,
    BaselineInterruptTimeQpc: ULONGLONG,
    QpcSystemTimeIncrement: ULONGLONG,
    QpcInterruptTimeIncrement: ULONGLONG,
    QpcSystemTimeIncrementShift: UCHAR,
    QpcInterruptTimeIncrementShift: UCHAR,
    UnparkedProcessorCount: USHORT,
    EnclaveFeatureMask: [4]ULONG,
    TelemetryCoverageRound: ULONG,
    UserModeGlobalLogger: [16]USHORT,
    ImageFileExecutionOptions: ULONG,
    LangGenerationCount: ULONG,
    Reserved4: ULONGLONG,
    InterruptTimeBias: ULONGLONG,
    QpcBias: ULONGLONG,
    ActiveProcessorCount: ULONG,
    ActiveGroupCount: UCHAR,
    Reserved9: UCHAR,
    DummyUnion5: extern union {
        QpcData: USHORT,
        Alt: extern struct {
            QpcBypassEnabled: UCHAR,
            QpcShift: UCHAR,
        },
    },
    TimeZoneBiasEffectiveStart: LARGE_INTEGER,
    TimeZoneBiasEffectiveEnd: LARGE_INTEGER,
    XState: XSTATE_CONFIGURATION,
    FeatureConfigurationChangeStamp: KSYSTEM_TIME,
    Spare: ULONG,
    UserPointerAuthMask: ULONG64,
};

/// 共享数据的只读用户态地址。
/// https://www.geoffchappell.com/studies/windows/km/ntoskrnl/inc/api/ntexapi_x/kuser_shared_data/index.htm
/// https://msrc-blog.microsoft.com/2022/04/05/randomizing-the-kuser_shared_data-structure-on-windows/
pub const SharedUserData: *const KUSER_SHARED_DATA = @ptrFromInt(0x7FFE0000);

pub fn IsProcessorFeaturePresent(feature: PF) bool {
    if (@backingInt(feature) >= PROCESSOR_FEATURE_MAX) return false;
    return SharedUserData.ProcessorFeatures[@backingInt(feature)].toBool();
}

// https://github.com/reactos/reactos/blob/master/sdk/include/ndk/pstypes.h#L977-L983
pub const KERNEL_USER_TIMES = extern struct {
    CreationTime: LARGE_INTEGER,
    ExitTime: LARGE_INTEGER,
    KernelTime: LARGE_INTEGER,
    UserTime: LARGE_INTEGER,
};

pub fn wtf8ToWtf16Le(wtf16le: []u16, wtf8: []const u8) error{ BadPathName, NameTooLong }!usize {
    // UTF-8/WTF-8 中的每个 u8 最多对应 UTF-16LE/WTF-16LE 中的一个 u16。
    if (wtf16le.len < wtf8.len) {
        const utf16_len = std.unicode.calcUtf16LeLenImpl(wtf8, .can_encode_surrogate_half) catch
            return error.BadPathName;
        if (utf16_len > wtf16le.len)
            return error.NameTooLong;
    }
    return std.unicode.wtf8ToWtf16Le(wtf16le, wtf8) catch |err| switch (err) {
        error.InvalidWtf8 => return error.BadPathName,
    };
}

/// 返回系统目录路径,通常为 "C:\\WINDOWS\\System32"。
///
/// 等同于 kernel32 中的 `GetSystemDirectoryW`。
pub fn getSystemDirectoryWtf16Le() [:0]const u16 {
    const ssd: *const BASE_STATIC_SERVER_DATA = @ptrCast(@alignCast(relocateCsrssAddress(
        peb().ReadOnlyStaticServerData.base_static_server_data_addr,
    )));
    return ssd.windows_system_directory.relocate().sliceZ();
}
// https://github.com/reactos/reactos/blob/4b75ec5508d47b726d1210e24f5a849dae4e3bda/sdk/include/reactos/subsys/win/base.h#L119
const BASE_STATIC_SERVER_DATA = extern struct {
    windows_directory: ForeignString,
    windows_system_directory: ForeignString,
    named_object_directory: ForeignString,
    /// 此项与 64 位版本的 `UNICODE_STRING` 匹配;即便目标为 32 位,此字符串也来自
    /// 64 位代码(因为它来自运行在 WOW64 之外的 CSRSS)。
    const ForeignString = extern struct {
        length: u16,
        maximum_length: u16,
        /// CSRSS 地址空间中的地址。若要将其转换为本进程地址空间中的有效指针,
        /// 参见 `relocateCsrssAddress` 或其包装函数 `ForeignString.relocate`。
        buffer_address: u64,
        fn relocate(str: ForeignString) UNICODE_STRING {
            return .{
                .Length = str.length,
                .MaximumLength = str.maximum_length,
                .Buffer = @ptrCast(@alignCast(@constCast(relocateCsrssAddress(str.buffer_address)))),
            };
        }
    };
};
/// 接受共享内存区域在 CSRSS 地址空间映射视图中的地址,
/// 返回该共享内存区域在本进程映射视图中的对应地址。
fn relocateCsrssAddress(addr: u64) *const anyopaque {
    const base: [*]const u8 = @ptrCast(peb().ReadOnlySharedMemoryBase);
    const offset: usize = @intCast(addr - peb().CsrServerReadOnlySharedMemoryBase);
    return base + offset;
}