此文件为 Windows 专有接口提供轻量封装,具体 目标如下:
- 将“errno”风格的错误码转换为 Zig 错误。
- 在需要空字符结尾或 WTF16LE 字节缓冲区时,既提供接受 切片的接口,也提供接受空字符结尾的 WTF16LE 字节缓冲区的接口。
builtinnative_archstdIomemassertmathmaxIntUnexpectedErrorkernel32ntdllws2_32crypt32nlscurrent_processPSOBJECTFILEDIRECTORYCONSOLEAFDTDINETDNSSYSTEMPROCESSTHREADHEAPCTL_CODEIOCTLMAXIMUM_REPARSE_DATA_BUFFER_SIZEIO_REPARSE_TAGACCESS_MASKDEVICE_TYPEFS_INFORMATION_CLASSSECTION_INHERITPAGEMEMSECERESOURCEVIRTUAL_MEMORYMEMORY_RANGE_ENTRYEVENT_TYPETIMER_TYPEWAIT_TYPELOGICALNTSTATUSGetProcessHeapGetCurrentProcessGetCurrentProcessIdGetCurrentThreadGetCurrentThreadIdGetLastErrorCloseHandleCreateProcessErrorCreateProcessFlagstebpebfromSysTimetoSysTimetoUpperWtf16eqlIgnoreCaseWtf16eqlIgnoreCaseWtf8testEqlIgnoreCaseRemoveDotDirsErrorremoveDotDirsSanitizednormalizePathhasCommonNtPrefixntToWin32NamespaceMAKELANGIDunexpectedErrorunexpectedStatusstatusBugerrorBugWin32ErrorLANGSUBLANGBOOLBOOLEANBYTECHARUCHARFLOATHANDLEHCRYPTPROVATOMHBRUSHHCURSORHICONHINSTANCEHMENUHMODULEHWNDHDCHGLRCFARPROCPROCINTLPCSTRLPCVOIDLPSTRLPVOIDLPWSTRLPCWSTRPVOIDPWSTRPCWSTRBSTRSIZE_TUINTULONG_PTRLONG_PTRDWORD_PTRWCHARWORDDWORDDWORD64LARGE_INTEGERULARGE_INTEGERUSHORTSHORTULONGLONGULONG64ULONGLONGLONGLONGLANGIDCOLORREFLPARAMva_listTCHARLPTSTRLPCTSTRPTSTRPCTSTRSTRINGANSI_STRINGUNICODE_STRINGBoolINVALID_HANDLE_VALUEINVALID_FILE_ATTRIBUTESIO_STATUS_BLOCKMAX_PATHSECURITY_ATTRIBUTESSTARTUPINFOWSTARTF_FORCEONFEEDBACKSTARTF_FORCEOFFFEEDBACKSTARTF_PREVENTPINNINGSTARTF_RUNFULLSCREENSTARTF_TITLEISAPPIDSTARTF_TITLEISLINKNAMESTARTF_UNTRUSTEDSOURCESTARTF_USECOUNTCHARSSTARTF_USEFILLATTRIBUTESTARTF_USEHOTKEYSTARTF_USEPOSITIONSTARTF_USESHOWWINDOWSTARTF_USESIZESTARTF_USESTDHANDLESTHREAD_START_ROUTINEUSER_THREAD_START_ROUTINEFILETIMEGUIDCOORDTLS_OUT_OF_INDEXESIMAGE_TLS_DIRECTORYIMAGE_TLS_DIRECTORY64IMAGE_TLS_DIRECTORY32PIMAGE_TLS_CALLBACKREGSAMLSTATUSHKEYHKEY_CLASSES_ROOTHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERSHKEY_PERFORMANCE_DATAHKEY_PERFORMANCE_TEXTHKEY_PERFORMANCE_NLSTEXTHKEY_CURRENT_CONFIGHKEY_DYN_DATAHKEY_CURRENT_USER_LOCAL_SETTINGSRTL_QUERY_REGISTRY_TABLERTL_QUERY_REGISTRY_ROUTINERTL_REGISTRY_ABSOLUTERTL_REGISTRY_SERVICESRTL_REGISTRY_CONTROLRTL_REGISTRY_WINDOWS_NTRTL_REGISTRY_DEVICEMAPRTL_REGISTRY_USERRTL_REGISTRY_MAXIMUMRTL_REGISTRY_HANDLERTL_REGISTRY_OPTIONALRTL_QUERY_REGISTRY_SUBKEYRTL_QUERY_REGISTRY_TOPKEYRTL_QUERY_REGISTRY_REQUIREDRTL_QUERY_REGISTRY_NOVALUERTL_QUERY_REGISTRY_NOEXPANDRTL_QUERY_REGISTRY_DIRECTRTL_QUERY_REGISTRY_DELETERTL_QUERY_REGISTRY_TYPECHECKREGKEYENABLE_VIRTUAL_TERMINAL_PROCESSINGDISABLE_NEWLINE_AUTO_RETURNFOREGROUND_BLUEFOREGROUND_GREENFOREGROUND_REDFOREGROUND_INTENSITYBACKGROUND_BLUEBACKGROUND_GREENBACKGROUND_REDBACKGROUND_INTENSITYLIST_ENTRYRTL_CRITICAL_SECTION_DEBUGRTL_CRITICAL_SECTIONCRITICAL_SECTIONINIT_ONCEINIT_ONCE_STATIC_INITINIT_ONCE_FNRTL_RUN_ONCERTL_RUN_ONCE_INITPATH_MAX_WIDENAME_MAXEXCEPTION_DATATYPE_MISALIGNMENTEXCEPTION_ACCESS_VIOLATIONEXCEPTION_ILLEGAL_INSTRUCTIONEXCEPTION_STACK_OVERFLOWEXCEPTION_CONTINUE_SEARCHEXCEPTION_RECORDFLOATING_SAVE_AREAM128AXMM_SAVE_AREA32NEON128CONTEXTRUNTIME_FUNCTIONKNONVOLATILE_CONTEXT_POINTERSEXCEPTION_POINTERSVECTORED_EXCEPTION_HANDLEREXCEPTION_DISPOSITIONEXCEPTION_ROUTINEUNWIND_HISTORY_TABLE_SIZEUNWIND_HISTORY_TABLE_ENTRYUNWIND_HISTORY_TABLEUNW_FLAG_NHANDLERUNW_FLAG_EHANDLERUNW_FLAG_UHANDLERUNW_FLAG_CHAININFOACTIVATION_CONTEXT_DATAASSEMBLY_STORAGE_MAPFLS_CALLBACK_INFORTL_BITMAPKAFFINITYKPRIORITYCLIENT_IDTEBEXCEPTION_REGISTRATION_RECORDNT_TIBPEBPEB_LDR_DATALDRRTL_USER_PROCESS_PARAMETERSRTL_DRIVE_LETTER_CURDIRPPS_POST_PROCESS_INIT_ROUTINEFILE_DIRECTORY_INFORMATIONFILE_BOTH_DIR_INFORMATIONFILE_BOTH_DIRECTORY_INFORMATIONFileInformationIteratorIO_APC_ROUTINECURDIRDUPLICATE_SAME_ACCESSMODULEINFOOSVERSIONINFOWRTL_OSVERSIONINFOWREPARSE_DATA_BUFFERSYMBOLIC_LINK_REPARSE_BUFFERMOUNT_POINT_REPARSE_BUFFERSYMLINK_FLAG_RELATIVESYMBOLIC_LINK_FLAG_DIRECTORYSYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATEMOUNTMGR_MOUNT_POINTMOUNTMGR_MOUNT_POINTSMOUNTMGR_TARGET_NAMEMOUNTMGR_VOLUME_PATHSSRWLOCK_INITSRWLOCKCONDITION_VARIABLE_INITCONDITION_VARIABLEPFMAX_WOW64_SHARED_ENTRIESPROCESSOR_FEATURE_MAXMAXIMUM_XSTATE_FEATURESKSYSTEM_TIMENT_PRODUCT_TYPEALTERNATIVE_ARCHITECTURE_TYPEXSTATE_FEATUREXSTATE_CONFIGURATIONKUSER_SHARED_DATASharedUserDataIsProcessorFeaturePresentKERNEL_USER_TIMESwtf8ToWtf16LegetSystemDirectoryWtf16LeBASE_STATIC_SERVER_DATArelocateCsrssAddress
std.os.windows.ACCESS_MASK
容器
字段
std.os.windows.ACCESS_MASK.Generic
容器
字段
ALL: bool = false
EXECUTE: bool = false
WRITE: bool = false
READ: bool = false
std.os.windows.ACCESS_MASK.Specific
容器
字段
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
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Enlistment
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_EXECUTE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Enlistment.GENERIC_WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Event
容器
字段
QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.Event.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.File
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.File.Directory
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.File.GENERIC_READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.File.GENERIC_WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.File.Pipe
容器
字段
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
容器
字段
Reserved0: u1 = 0
MODIFY_STATE: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.IoCompletion.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.JobObject
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Key
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Key.EXECUTE
别名
等同于 KEY_READ。
std.os.windows.ACCESS_MASK.Specific.Key.READ
常量
组合 STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS 和 KEY_NOTIFY 的值。
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Key.WOW64_RES
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Key.WRITE
常量
组合 STANDARD_RIGHTS_WRITE、KEY_SET_VALUE 和 KEY_CREATE_SUB_KEY 访问权限。
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.MemoryPartition
容器
字段
QUERY_ACCESS: bool = false
MODIFY_ACCESS: bool = false
Required2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.MemoryPartition.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Mutant
容器
字段
QUERY_STATE: bool = false
Reserved1: u15 = 0
std.os.windows.ACCESS_MASK.Specific.Mutant.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.ObjectType
容器
字段
CREATE: bool = false
Reserved1: u15 = 0
std.os.windows.ACCESS_MASK.Specific.ObjectType.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Process
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.ResourceManager
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_EXECUTE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.ResourceManager.GENERIC_WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.RIGHTS_ALL
常量
Specific
std.os.windows.ACCESS_MASK.Specific.Section
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Semaphore
容器
字段
QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.Semaphore.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Session
容器
字段
QUERY_ACCESS: bool = false
MODIFY_ACCESS: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.Session.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.SymbolicLink
容器
字段
QUERY: bool = false
SET: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.SymbolicLink.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.SymbolicLink.ALL_ACCESS_EX
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Thread
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Timer
容器
字段
QUERY_STATE: bool = false
MODIFY_STATE: bool = false
Reserved2: u14 = 0
std.os.windows.ACCESS_MASK.Specific.Timer.ALL_ACCESS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.ALL_ACCESS_P
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.EXECUTE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.TRUST_ALLOWED_MASK
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.TRUST_CONSTRAINT_MASK
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Token.WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Transaction
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_EXECUTE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Transaction.GENERIC_WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.Transaction.RESOURCE_MANAGER_RIGHTS
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.TransactionManager
容器
字段
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
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_EXECUTE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_READ
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Specific.TransactionManager.GENERIC_WRITE
常量
ACCESS_MASK
std.os.windows.ACCESS_MASK.Standard
容器
字段
RIGHTS: Rights = .{}
SYNCHRONIZE: bool = false
std.os.windows.ACCESS_MASK.Standard.Rights
容器
字段
DELETE: bool = false
READ_CONTROL: bool = false
WRITE_DAC: bool = false
WRITE_OWNER: bool = false
std.os.windows.ACCESS_MASK.Standard.RIGHTS_ALL
常量
Standard
std.os.windows.ACCESS_MASK.Standard.Rights.ALL
别名
std.os.windows.ACCESS_MASK.Standard.Rights.EXECUTE
常量
Rights
std.os.windows.ACCESS_MASK.Standard.Rights.READ
常量
Rights
std.os.windows.ACCESS_MASK.Standard.Rights.REQUIRED
常量
Rights
std.os.windows.ACCESS_MASK.Standard.Rights.WRITE
常量
Rights
std.os.windows.ACTIVATION_CONTEXT_DATA
容器
std.os.windows.AFD
容器
字段
NO_FAST_IO: bool = false
OVERLAPPED: bool = false
Reserved0: u30 = 0
MutabilityWSABUFGUARANTEEDEVICE_NAMEENDPOINT_TYPEOPEN_PACKETBIND_INFOLISTEN_INFOLISTEN_RESPONSE_INFOACCEPT_INFOSUPER_ACCEPT_INFODEFER_ACCEPT_INFOPARTIAL_DISCONNECT_INFORECEIVE_INFORMATIONHANDLE_INFOINFORMATIONTRANSMIT_FILE_INFOQUEUE_APC_INFOSEND_INFOSEND_DATAGRAM_INFORECV_INFORECV_DATAGRAM_INFOSOCKOPT_INFO
std.os.windows.AFD.ACCEPT_INFO
容器
字段
std.os.windows.AFD.BIND_INFO
容器
字段
Mode: MODE
std.os.windows.AFD.BIND_INFO.MODE
容器
字段
Unix = 0
Passive = 1
Active = 2
_
std.os.windows.AFD.DEFER_ACCEPT_INFO
容器
字段
std.os.windows.AFD.DEVICE_NAME
常量
[]const u16
std.os.windows.AFD.ENDPOINT_TYPE
容器
字段
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
容器
字段
BestEffort
ControlledLoad
Predictive
GuaranteedDelay
Guaranteed
_
std.os.windows.AFD.HANDLE_INFO
容器
字段
std.os.windows.AFD.INFORMATION
容器
字段
InformationType: TYPE
Information: extern union {
Boolean: BOOLEAN,
Ulong: ULONG,
LargeInteger: LARGE_INTEGER,
}
std.os.windows.AFD.INFORMATION.TYPE
容器
字段
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
容器
字段
std.os.windows.AFD.LISTEN_RESPONSE_INFO
容器
字段
Sequence: ULONG
std.os.windows.AFD.Mutability
容器
字段
@"const"
@"var"
std.os.windows.AFD.OPEN_PACKET
容器
字段
std.os.windows.AFD.OPEN_PACKET.FULL_EA_INFORMATION
容器
字段
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
常量
std.os.windows.AFD.PARTIAL_DISCONNECT_INFO
容器
字段
DisconnectMode: MODE
Timeout: LARGE_INTEGER
std.os.windows.AFD.PARTIAL_DISCONNECT_INFO.MODE
容器
字段
SEND: bool = false
RECEIVE: bool = false
ABORTIVE: bool = false
UNCONNECT_DATAGRAM: bool = false
Reserved4: u28 = 0
std.os.windows.AFD.QUEUE_APC_INFO
容器
字段
std.os.windows.AFD.RECEIVE_INFORMATION
容器
字段
std.os.windows.AFD.RECV_DATAGRAM_INFO
容器
字段
std.os.windows.AFD.RECV_INFO
容器
字段
std.os.windows.AFD.SEND_DATAGRAM_INFO
容器
字段
BufferArray: [*]const WSABUF(.@"const")
BufferCount: ULONG
AfdFlags: AFD
TdiRequest: TDI.REQUEST.SEND_DATAGRAM
TdiConnInfo: TDI.CONNECTION.INFORMATION
std.os.windows.AFD.SEND_INFO
容器
字段
std.os.windows.AFD.SOCKOPT_INFO
容器
字段
std.os.windows.AFD.SOCKOPT_INFO.Mode
容器
字段
set = 1
get = 2
special = 3
_
std.os.windows.AFD.SOCKOPT_INFO.UNIX_PATH
容器
字段
Unknown0: usize = 0
Path: [PATH_MAX_WIDE:0]u16
std.os.windows.AFD.SUPER_ACCEPT_INFO
容器
字段
std.os.windows.AFD.TRANSMIT_FILE_INFO
容器
字段
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
容器
字段
DISCONNECT: bool = false
REUSE_SOCKET: bool = false
WRITE_BEHIND: bool = false
Reserved3: u25 = 0
std.os.windows.AFD.WSABUF
类型函数
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
容器
字段
StandardDesign
NEC98x86
EndAlternatives
std.os.windows.ANSI_STRING
类型
std.os.windows.ASSEMBLY_STORAGE_MAP
容器
std.os.windows.assert
别名
别名目标 std.debug.assert
std.os.windows.ATOM
类型
std.os.windows.BACKGROUND_BLUE
常量
std.os.windows.BACKGROUND_GREEN
常量
std.os.windows.BACKGROUND_INTENSITY
常量
std.os.windows.BACKGROUND_RED
常量
std.os.windows.BASE_STATIC_SERVER_DATA
容器
字段
windows_directory: ForeignString
windows_system_directory: ForeignString
named_object_directory: ForeignString
std.os.windows.BASE_STATIC_SERVER_DATA.ForeignString
容器
此项与 64 位版本的 UNICODE_STRING 匹配;即便目标为 32 位,此字符串也来自
64 位代码(因为它来自运行在 WOW64 之外的 CSRSS)。
字段
length: u16
maximum_length: u16
buffer_address: u64CSRSS 地址空间中的地址。若要将其转换为本进程地址空间中的有效指针,
参见 relocateCsrssAddress 或其包装函数 ForeignString.relocate。
std.os.windows.BASE_STATIC_SERVER_DATA.ForeignString.relocate
函数
fn relocate(str: ForeignString) UNICODE_STRING
参数
str: ForeignString
std.os.windows.Bool
类型函数
fn Bool(comptime BackingInteger: type) type
参数
BackingInteger: type
字段
FALSE = 0false
_true
std.os.windows.BOOL
类型
std.os.windows.Bool.Backing
常量
std.os.windows.Bool.fromBool
函数
pub fn fromBool(b: bool) @This()
参数
b: bool
std.os.windows.Bool.toBool
函数
pub fn toBool(b: @This()) bool
参数
b: @This()
std.os.windows.Bool.TRUE
常量
这不是唯一的真值;与此值进行比较始终是缺陷。
@This()
std.os.windows.BOOLEAN
类型
std.os.windows.BSTR
类型
由 SysAllocString 分配,由 SysFreeString 释放。
std.os.windows.builtin
常量
std.os.windows.BYTE
类型
std.os.windows.CHAR
类型
std.os.windows.CLIENT_ID
容器
字段
std.os.windows.CloseHandle
函数
pub fn CloseHandle(hObject: HANDLE) void
参数
hObject: HANDLE
std.os.windows.COLORREF
别名
别名目标 std.os.windows.DWORD
std.os.windows.CONDITION_VARIABLE
容器
字段
Ptr: ?PVOID = null
std.os.windows.CONDITION_VARIABLE_INIT
常量
std.os.windows.CONSOLE
命名空间
std.os.windows.CONSOLE.USER_IO
命名空间
std.os.windows.CONSOLE.USER_IO.FILL
函数
pub fn FILL(with: INFO.FILL.WITH, len: DWORD, coord: COORD) Header.With(INFO.FILL)
参数
std.os.windows.CONSOLE.USER_IO.GET_CP
函数
pub fn GET_CP(mode: INFO.CP.MODE) Header.With(INFO.CP)
参数
std.os.windows.CONSOLE.USER_IO.GET_MODE
常量
Header.With(DWORD)
std.os.windows.CONSOLE.USER_IO.GET_SCREEN_BUFFER_INFO
常量
Header.With(INFO.SCREEN_BUFFER)
std.os.windows.CONSOLE.USER_IO.Header
容器
字段
Operation: Operation
Size: u32
std.os.windows.CONSOLE.USER_IO.Header.With
类型函数
pub fn With(comptime Data: type) type
参数
Data: type
字段
Header: Header
Data: Data
std.os.windows.CONSOLE.USER_IO.Header.With.init
函数
pub fn init(operation: Operation, data: Data) @This()
参数
operation: Operation
data: Data
std.os.windows.CONSOLE.USER_IO.Header.With.operate
函数
pub fn operate(with: *@This(), io: Io, file: ?Io.File) Io.Cancelable!NTSTATUS
参数
错误
- Canceled
调用方请求停止异步操作。
std.os.windows.CONSOLE.USER_IO.Header.With.request
函数
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
命名空间
std.os.windows.CONSOLE.USER_IO.INFO.CP
容器
字段
std.os.windows.CONSOLE.USER_IO.INFO.CP.MODE
容器
字段
Input
Output
std.os.windows.CONSOLE.USER_IO.INFO.FILL
容器
字段
std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH
容器
字段
std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH.Payload
常量
std.os.windows.CONSOLE.USER_IO.INFO.FILL.WITH.Tag
常量
std.os.windows.CONSOLE.USER_IO.INFO.READ_OUTPUT_CHARACTER
容器
字段
std.os.windows.CONSOLE.USER_IO.INFO.READ_OUTPUT_CHARACTER.MODE
容器
字段
Character = 1
WideCharacter = 2
std.os.windows.CONSOLE.USER_IO.INFO.SCREEN_BUFFER
容器
全部输出
字段
std.os.windows.CONSOLE.USER_IO.INFO.WRITE
容器
字段
std.os.windows.CONSOLE.USER_IO.INFO.WRITE.MODE
容器
字段
Character
WideCharacter
std.os.windows.CONSOLE.USER_IO.InputBuffer
容器
字段
Size: u32
Pointer: *const anyopaque
std.os.windows.CONSOLE.USER_IO.Operation
容器
字段
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
容器
字段
Size: u32
Pointer: *anyopaque
std.os.windows.CONSOLE.USER_IO.READ_OUTPUT_CHARACTER
函数
pub fn READ_OUTPUT_CHARACTER( coord: COORD, mode: INFO.READ_OUTPUT_CHARACTER.MODE, ) Header.With(INFO.READ_OUTPUT_CHARACTER)
参数
coord: COORD
mode: INFO.READ_OUTPUT_CHARACTER.MODE
std.os.windows.CONSOLE.USER_IO.Request
类型函数
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
函数
pub fn init( handle: ?HANDLE, in: [in_len]InputBuffer, out: [out_len]OutputBuffer, ) @This()
参数
std.os.windows.CONSOLE.USER_IO.SET_CP
函数
pub fn SET_CP(mode: INFO.CP.MODE, cp: UINT) Header.With(INFO.CP)
参数
std.os.windows.CONSOLE.USER_IO.SET_CURSOR_POSITION
函数
pub fn SET_CURSOR_POSITION(coord: COORD) Header.With(COORD)
参数
coord: COORD
std.os.windows.CONSOLE.USER_IO.SET_MODE
函数
pub fn SET_MODE(mode: DWORD) Header.With(DWORD)
参数
mode: DWORD
std.os.windows.CONSOLE.USER_IO.SET_TEXT_ATTRIBUTE
函数
pub fn SET_TEXT_ATTRIBUTE(attribute: WORD) Header.With(WORD)
参数
attribute: WORD
std.os.windows.CONSOLE.USER_IO.WRITE
函数
pub fn WRITE(mode: INFO.WRITE.MODE) Header.With(INFO.WRITE)
参数
std.os.windows.CONTEXT
类型
std.os.windows.CONTEXT.getRegs
类型函数
pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }
参数
ctx: *const CONTEXT
std.os.windows.CONTEXT.getRegs
类型函数
pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }
参数
ctx: *const CONTEXT
std.os.windows.CONTEXT.getRegs
类型函数
pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }
参数
ctx: *const CONTEXT
std.os.windows.CONTEXT.getRegs
类型函数
pub fn getRegs(ctx: *const CONTEXT) struct { bp: usize, ip: usize, sp: usize }
参数
ctx: *const CONTEXT
std.os.windows.CONTEXT.setIp
函数
pub fn setIp(ctx: *CONTEXT, ip: usize) void
参数
ctx: *CONTEXT
ip: usize
std.os.windows.CONTEXT.setIp
函数
pub fn setIp(ctx: *CONTEXT, ip: usize) void
参数
ctx: *CONTEXT
ip: usize
std.os.windows.CONTEXT.setIp
函数
pub fn setIp(ctx: *CONTEXT, ip: usize) void
参数
ctx: *CONTEXT
ip: usize
std.os.windows.CONTEXT.setSp
函数
pub fn setSp(ctx: *CONTEXT, sp: usize) void
参数
ctx: *CONTEXT
sp: usize
std.os.windows.CONTEXT.setSp
函数
pub fn setSp(ctx: *CONTEXT, sp: usize) void
参数
ctx: *CONTEXT
sp: usize
std.os.windows.CONTEXT.setSp
函数
pub fn setSp(ctx: *CONTEXT, sp: usize) void
参数
ctx: *CONTEXT
sp: usize
std.os.windows.COORD
容器
字段
std.os.windows.CreateProcessError
错误集合
错误
- AccessDenied
- FileBusy
- FileNotFound
- InvalidExe
- InvalidName
- NameTooLong
- SystemResources
- Unexpected
std.os.windows.CreateProcessFlags
容器
字段
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
别名
std.os.windows.crypt32
别名
std.os.windows.CTL_CODE
容器
字段
std.os.windows.CTL_CODE.FILE_ACCESS
容器
字段
READ: bool = false
WRITE: bool = false
std.os.windows.CTL_CODE.FILE_ACCESS.ANY
常量
FILE_ACCESS
std.os.windows.CTL_CODE.FILE_ACCESS.SPECIAL
别名
std.os.windows.CTL_CODE.FILE_DEVICE
容器
字段
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
常量
CTL_CODE
std.os.windows.CTL_CODE.METHOD
容器
字段
BUFFERED = 0
IN_DIRECT = 1
OUT_DIRECT = 2
NEITHER = 3
std.os.windows.CTL_CODE.PIPE
命名空间
ASSIGN_EVENTDISCONNECTLISTENPEEKQUERY_EVENTTRANSCEIVEWAITIMPERSONATESET_CLIENT_PROCESSQUERY_CLIENT_PROCESSGET_PIPE_ATTRIBUTESET_PIPE_ATTRIBUTEGET_CONNECTION_ATTRIBUTESET_CONNECTION_ATTRIBUTEGET_HANDLE_ATTRIBUTESET_HANDLE_ATTRIBUTEFLUSHINTERNAL_READINTERNAL_WRITEINTERNAL_TRANSCEIVEINTERNAL_READ_OVFLOW
std.os.windows.CTL_CODE.PIPE.ASSIGN_EVENT
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.DISCONNECT
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.FLUSH
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.GET_CONNECTION_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.GET_HANDLE_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.GET_PIPE_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.IMPERSONATE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.INTERNAL_READ
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.INTERNAL_READ_OVFLOW
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.INTERNAL_TRANSCEIVE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.INTERNAL_WRITE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.LISTEN
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.PEEK
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.QUERY_CLIENT_PROCESS
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.QUERY_EVENT
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.SET_CLIENT_PROCESS
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.SET_CONNECTION_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.SET_HANDLE_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.SET_PIPE_ATTRIBUTE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.TRANSCEIVE
常量
CTL_CODE
std.os.windows.CTL_CODE.PIPE.WAIT
常量
CTL_CODE
std.os.windows.CTL_CODE.SET_REPARSE_POINT
常量
CTL_CODE
std.os.windows.CURDIR
容器
字段
DosPath: UNICODE_STRING
Handle: HANDLE
std.os.windows.current_process
常量
HANDLE
std.os.windows.DEVICE_TYPE
容器
字段
FileDevice: CTL_CODE.FILE_DEVICE
Reserved16: u16 = 0
std.os.windows.DIRECTORY
命名空间
std.os.windows.DIRECTORY.NOTIFY_INFORMATION_CLASS
容器
字段
Notify = 1
NotifyExtended = 2
NotifyFull = 3
_
std.os.windows.DIRECTORY.NOTIFY_INFORMATION_CLASS.Maximum
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.DISABLE_NEWLINE_AUTO_RETURN
常量
std.os.windows.DNS
命名空间
std.os.windows.DNS.ADDR
容器
字段
MaxSa: [ADDR_MAX_SOCKADDR_LENGTH]CHAR
DnsAddrUserDword: [8]DWORD
std.os.windows.DNS.ADDR_MAX_SOCKADDR_LENGTH
常量
std.os.windows.DNS.ADDR.ARRAY
容器
字段
std.os.windows.DNS.CUSTOM_SERVER
容器
字段
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
容器
字段
UDP_FALLBACK: bool = false
UPGRADE_FROM_WELL_KNOWN_SERVERS: bool = false
Reserved2: u62 = 0
std.os.windows.DNS.CUSTOM_SERVER.TYPE
容器
字段
UDP = 0x1
DOH = 0x2
DOT = 0x3
_
std.os.windows.DNS.FREE_TYPE
容器
字段
Flat = 0
RecordList
ParsedMessageFields
std.os.windows.DNS.INTERFACE_SETTINGS
容器
字段
std.os.windows.DNS.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
std.os.windows.DNS.QUERY.CANCEL
容器
字段
Reserved: [32]CHAR align(8)
std.os.windows.DNS.QUERY.COMPLETION_ROUTINE
常量
std.os.windows.DNS.QUERY.REQUEST
容器
字段
std.os.windows.DNS.QUERY.REQUEST.@"3"
容器
字段
Base: REQUEST
IsNetworkQueryRequired: BOOL = .FALSE
RequiredNetworkIndex: DWORD = 0
cCustomServers: DWORD = 0
pCustomServers: ?*CUSTOM_SERVER = null
std.os.windows.DNS.QUERY.RESULT
容器
字段
std.os.windows.DNS.QUERY.STANDARD
常量
QUERY
std.os.windows.DNS.RECORD
容器
字段
std.os.windows.DNS.RECORD.FLAGS
容器
字段
std.os.windows.DNS.SECTION
容器
字段
Question
Answer
Authority
Additional
std.os.windows.DNS.STATUS
别名
std.os.windows.DNS.TYPE
容器
字段
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
常量
TYPE
std.os.windows.DNS.TYPE.NBSTAT
常量
TYPE
std.os.windows.DUPLICATE_SAME_ACCESS
常量
std.os.windows.DWORD
类型
std.os.windows.DWORD_PTR
别名
std.os.windows.DWORD64
类型
std.os.windows.ENABLE_VIRTUAL_TERMINAL_PROCESSING
常量
std.os.windows.eqlIgnoreCaseWtf16
函数
以等同于启用大小写不敏感比较的
RtlEqualUnicodeString 的方式,比较两个 WTF16 字符串。
此函数可在任何目标上调用。
pub fn eqlIgnoreCaseWtf16(a: []const u16, b: []const u16) bool
参数
a: []const u16
b: []const u16
std.os.windows.eqlIgnoreCaseWtf8
函数
以等同于启用大小写不敏感比较的
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
容器
std.os.windows.errorBug
函数
pub fn errorBug(err: Win32Error) UnexpectedError
参数
err: Win32Error
std.os.windows.EVENT_TYPE
容器
字段
Notification
Synchronization
std.os.windows.EXCEPTION_ACCESS_VIOLATION
常量
std.os.windows.EXCEPTION_CONTINUE_SEARCH
常量
std.os.windows.EXCEPTION_DATATYPE_MISALIGNMENT
常量
std.os.windows.EXCEPTION_DISPOSITION
类型
std.os.windows.EXCEPTION_ILLEGAL_INSTRUCTION
常量
std.os.windows.EXCEPTION_POINTERS
容器
字段
ExceptionRecord: *EXCEPTION_RECORD
ContextRecord: *CONTEXT
std.os.windows.EXCEPTION_RECORD
容器
字段
ExceptionCode: u32
ExceptionFlags: u32
ExceptionRecord: *EXCEPTION_RECORD
ExceptionAddress: *anyopaque
NumberParameters: u32
ExceptionInformation: [15]usize
std.os.windows.EXCEPTION_REGISTRATION_RECORD
容器
字段
Next: ?*EXCEPTION_REGISTRATION_RECORD
Handler: ?*EXCEPTION_DISPOSITION
std.os.windows.EXCEPTION_ROUTINE
类型
std.os.windows.EXCEPTION_STACK_OVERFLOW
常量
std.os.windows.FARPROC
类型
std.os.windows.FILE
命名空间
END_OF_FILE_INFORMATIONALIGNMENT_INFORMATIONNAME_INFORMATIONDISPOSITIONFS_VOLUME_INFORMATIONNAME_FLAGSNOTIFYPIPEALL_INFORMATIONINTERNAL_INFORMATIONEA_INFORMATIONACCESS_INFORMATIONRENAME_INFORMATIONINFORMATION_CLASSBASIC_INFORMATIONSTANDARD_INFORMATIONPOSITION_INFORMATIONFULL_EA_INFORMATIONFS_DEVICE_INFORMATIONUSE_FILE_POINTER_POSITIONATTRIBUTE_TAG_INFOSHAREATTRIBUTECREATE_DISPOSITIONMODE
std.os.windows.FILE_BOTH_DIR_INFORMATION
容器
字段
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
别名
std.os.windows.FILE_DIRECTORY_INFORMATION
容器
字段
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
容器
字段
AccessFlags: ACCESS_MASK
std.os.windows.FILE.ALIGNMENT_INFORMATION
容器
字段
AlignmentRequirement: ULONG
std.os.windows.FILE.ALL_INFORMATION
容器
字段
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
容器
字段
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
容器
字段
FileAttributes: DWORD
ReparseTag: IO_REPARSE_TAG
std.os.windows.FILE.BASIC_INFORMATION
容器
字段
CreationTime: LARGE_INTEGER
LastAccessTime: LARGE_INTEGER
LastWriteTime: LARGE_INTEGER
ChangeTime: LARGE_INTEGER
FileAttributes: ATTRIBUTE
std.os.windows.FILE.CREATE_DISPOSITION
容器
定义创建处置方式的取值
字段
SUPERSEDE = 0x00000000若文件已存在,则用给定文件替换;若不存在,则创建给定文件。
OPEN = 0x00000001若文件已存在,则打开它而不创建新文件。 若不存在,则使请求失败,不创建文件。
CREATE = 0x00000002若文件已存在,则使请求失败,不创建也不打开指定文件。若不存在,则创建。
OPEN_IF = 0x00000003如果文件已存在,则打开;如果不存在,则创建给定文件。
OVERWRITE = 0x00000004如果文件已存在,则打开并覆盖;如果不存在,则使请求失败。
OVERWRITE_IF = 0x00000005若文件已存在,则打开并覆盖它;若不存在,则创建给定文件。
std.os.windows.FILE.CREATE_DISPOSITION.MAXIMUM_DISPOSITION
常量
CREATE_DISPOSITION
std.os.windows.FILE.DISPOSITION
容器
字段
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
常量
DISPOSITION
std.os.windows.FILE.DISPOSITION.INFORMATION
容器
字段
DeleteFile: BOOLEAN
std.os.windows.FILE.DISPOSITION.INFORMATION.EX
容器
字段
Flags: DISPOSITION
std.os.windows.FILE.EA_INFORMATION
容器
字段
EaSize: ULONG
std.os.windows.FILE.END_OF_FILE_INFORMATION
容器
字段
EndOfFile: LARGE_INTEGER
std.os.windows.FILE.FS_DEVICE_INFORMATION
容器
字段
DeviceType: DEVICE_TYPE
Characteristics: ULONG
std.os.windows.FILE.FS_VOLUME_INFORMATION
容器
字段
VolumeCreationTime: LARGE_INTEGER
VolumeSerialNumber: ULONG
VolumeLabelLength: ULONG
SupportsObjects: BOOLEAN
VolumeLabel: [0]WCHAR
std.os.windows.FILE.FS_VOLUME_INFORMATION.getVolumeLabel
函数
pub fn getVolumeLabel(fvi: *const FS_VOLUME_INFORMATION) []const WCHAR
参数
fvi: *const FS_VOLUME_INFORMATION
std.os.windows.FILE.FULL_EA_INFORMATION
容器
字段
std.os.windows.FILE.INFORMATION_CLASS
容器
字段
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
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.FILE.INTERNAL_INFORMATION
容器
字段
IndexNumber: LARGE_INTEGER
std.os.windows.FILE.MODE
容器
定义创建或打开选项的标志
字段
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 = falseObjectAttributes 参数指定的文件名
包含文件的 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
容器
字段
std.os.windows.FILE.MODE.VALID_FLAGS
常量
@This()
std.os.windows.FILE.MODE.VALID_MAILSLOT_OPTION_FLAGS
常量
MODE
std.os.windows.FILE.MODE.VALID_OPTION_FLAGS
常量
MODE
std.os.windows.FILE.MODE.VALID_PIPE_OPTION_FLAGS
常量
MODE
std.os.windows.FILE.MODE.VALID_SET_OPTION_FLAGS
常量
MODE
std.os.windows.FILE.NAME_FLAGS
容器
字段
NTFS: bool = false
DOS: bool = false
Reserved2: u5 = 0
UNSPECIFIED: bool = false
std.os.windows.FILE.NAME_INFORMATION
容器
字段
std.os.windows.FILE.NOTIFY
命名空间
std.os.windows.FILE.NOTIFY.CHANGE
容器
字段
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
容器
字段
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
函数
pub fn fileName(info: *INFORMATION) []WCHAR
参数
info: *INFORMATION
std.os.windows.FILE.NOTIFY.FULL_INFORMATION
容器
字段
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
函数
pub fn fileName(info: *INFORMATION) []WCHAR
参数
info: *INFORMATION
std.os.windows.FILE.NOTIFY.INFORMATION
容器
字段
std.os.windows.FILE.NOTIFY.INFORMATION.fileName
函数
pub fn fileName(info: *INFORMATION) []WCHAR
参数
info: *INFORMATION
std.os.windows.FILE.PIPE
命名空间
std.os.windows.FILE.PIPE.COMPLETION_MODE
容器
定义 NtCreateNamedPipeFile 的 CompletionMode 标志
字段
OPERATION: enum(u1) {
QUEUE = 0b0,
COMPLETE = 0b1,
} = .QUEUE
Reserved1: u31 = 0
std.os.windows.FILE.PIPE.CONFIGURATION
容器
定义 NtQueryInformationFile 的 NamedPipeConfiguration 标志
字段
INBOUND = 0x00000000
OUTBOUND = 0x00000001
FULL_DUPLEX = 0x00000002
std.os.windows.FILE.PIPE.END
容器
为 NtQueryInformationFile 定义 NamedPipeEnd 标志。
字段
CLIENT = 0x00000000
SERVER = 0x00000001
std.os.windows.FILE.PIPE.INFORMATION
容器
字段
ReadMode: READ_MODE
CompletionMode: COMPLETION_MODE
std.os.windows.FILE.PIPE.LOCAL_INFORMATION
容器
字段
std.os.windows.FILE.PIPE.READ_MODE
容器
为 NtCreateNamedPipeFile 定义 ReadMode 标志。
字段
MODE: enum(u1) {
BYTE_STREAM = 0b0,
MESSAGE = 0b1,
}
Reserved1: u31 = 0
std.os.windows.FILE.PIPE.REMOTE_INFORMATION
容器
字段
CollectDataTime: LARGE_INTEGER
MaximumCollectionCount: ULONG
std.os.windows.FILE.PIPE.STATE
容器
为 NtQueryInformationFile 定义 NamedPipeState 标志。
字段
DISCONNECTED = 0x00000001
LISTENING = 0x00000002
CONNECTED = 0x00000003
CLOSING = 0x00000004
std.os.windows.FILE.PIPE.TYPE
容器
定义 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
常量
TYPE
std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER
容器
字段
std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.getName
函数
pub fn getName(fpwfb: *const WAIT_FOR_BUFFER) []const WCHAR
参数
fpwfb: *const WAIT_FOR_BUFFER
std.os.windows.FILE.PIPE.WAIT_FOR_BUFFER.init
函数
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
函数
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
常量
LARGE_INTEGER
std.os.windows.FILE.POSITION_INFORMATION
容器
字段
CurrentByteOffset: LARGE_INTEGER
std.os.windows.FILE.RENAME_INFORMATION
容器
没有将其拆分为 RENAME_INFORMATION 和 RENAME_INFORMATION_EX,因为
两者的唯一区别是 Flags 类型(_EX 之前为 BOOLEAN,_EX 中为 ULONG),
这不会影响结构布局;RootDirectory 的偏移量无论如何都相同。
字段
std.os.windows.FILE.RENAME_INFORMATION.FLAGS
容器
字段
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
函数
pub fn getFileName(ri: *const RENAME_INFORMATION) []const WCHAR
参数
ri: *const RENAME_INFORMATION
std.os.windows.FILE.RENAME_INFORMATION.init
函数
pub fn init(opts: struct { Flags: FLAGS = .{}, RootDirectory: ?HANDLE = null, FileName: []const WCHAR, }) RENAME_INFORMATION
参数
std.os.windows.FILE.RENAME_INFORMATION.toBuffer
函数
pub fn toBuffer(fri: *RENAME_INFORMATION) []u8
参数
fri: *RENAME_INFORMATION
std.os.windows.FILE.SHARE
容器
字段
READ: bool = false其他线程可打开此文件进行读取访问。
WRITE: bool = false其他线程可打开该文件以获取写入访问权限。
DELETE: bool = false其他线程可打开该文件以获取删除访问权限。
Reserved3: u29 = 0
std.os.windows.FILE.SHARE.VALID_FLAGS
常量
SHARE
std.os.windows.FILE.STANDARD_INFORMATION
容器
字段
AllocationSize: LARGE_INTEGER
EndOfFile: LARGE_INTEGER
NumberOfLinks: ULONG
DeletePending: BOOLEAN
Directory: BOOLEAN
std.os.windows.FILE.USE_FILE_POINTER_POSITION
常量
std.os.windows.FileInformationIterator
类型函数
用于遍历 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
函数
pub fn next(self: *@This()) ?*FileInformationType
参数
self: *@This()
std.os.windows.FILETIME
容器
字段
std.os.windows.FLOAT
类型
std.os.windows.FLOATING_SAVE_AREA
类型
std.os.windows.FLS_CALLBACK_INFO
容器
std.os.windows.FOREGROUND_BLUE
常量
std.os.windows.FOREGROUND_GREEN
常量
std.os.windows.FOREGROUND_INTENSITY
常量
std.os.windows.FOREGROUND_RED
常量
std.os.windows.fromSysTime
函数
文件时间是一个 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
容器
字段
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
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.GetCurrentProcess
函数
pub fn GetCurrentProcess() HANDLE
std.os.windows.GetCurrentProcessId
函数
pub fn GetCurrentProcessId() DWORD
std.os.windows.GetCurrentThread
函数
pub fn GetCurrentThread() HANDLE
std.os.windows.GetCurrentThreadId
函数
pub fn GetCurrentThreadId() DWORD
std.os.windows.GetLastError
函数
pub fn GetLastError() Win32Error
std.os.windows.GetProcessHeap
函数
pub fn GetProcessHeap() ?*HEAP
std.os.windows.getSystemDirectoryWtf16Le
函数
返回系统目录路径,通常为 "C:\WINDOWS\System32"。
等同于 kernel32 中的 GetSystemDirectoryW。
pub fn getSystemDirectoryWtf16Le() [:0]const u16
std.os.windows.GUID
容器
字段
Data1: u32
Data2: u16
Data3: u16
Data4: [8]u8
std.os.windows.GUID.format
函数
pub fn format(self: GUID, w: *std.Io.Writer) std.Io.Writer.Error!void
参数
错误
- 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
常量
[16]u6
std.os.windows.GUID.parse
函数
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
函数
pub fn parseNoBraces(s: []const u8) !GUID
参数
s: []const u8
std.os.windows.HANDLE
类型
std.os.windows.hasCommonNtPrefix
函数
若路径以 \??\ 开头,则返回 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
类型
std.os.windows.HCRYPTPROV
别名
std.os.windows.HCURSOR
类型
std.os.windows.HDC
类型
std.os.windows.HEAP
容器
std.os.windows.HEAP.FLAGS
容器
字段
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
容器
字段
std.os.windows.HEAP.FLAGS.CLASS
容器
字段
std.os.windows.HEAP.FLAGS.CLASS.MASK
常量
CLASS
std.os.windows.HEAP.FLAGS.CREATE
容器
字段
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
常量
CREATE
std.os.windows.HEAP.RTL_PARAMETERS
容器
字段
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
常量
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT
容器
字段
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.FLG
容器
字段
USE_PAGE_HEAP: bool = false
NO_LFH: bool = false
Reserved2: u30 = 0
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.FLG.VALID_FLAGS
常量
FLG
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE
容器
字段
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.TYPE
容器
字段
Paged
NonPaged
@"64KPage"
LargePage
HugePage
Custom
_
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.TYPE.Max
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS
容器
字段
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
常量
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.FREE_VIRTUAL_MEMORY_EX_CALLBACK
常量
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.MEMORY_INFO_CLASS
容器
字段
Basic
_
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.MEMORY_SOURCE.VA_CALLBACKS.QUERY_VIRTUAL_MEMORY_CALLBACK
常量
std.os.windows.HEAP.RTL_PARAMETERS.SEGMENT.VERSION
容器
字段
CURRENT = 3
_
std.os.windows.HGLRC
类型
std.os.windows.HICON
类型
std.os.windows.HINSTANCE
类型
std.os.windows.HKEY
类型
std.os.windows.HKEY_CLASSES_ROOT
常量
HKEY
std.os.windows.HKEY_CURRENT_CONFIG
常量
HKEY
std.os.windows.HKEY_CURRENT_USER
常量
HKEY
std.os.windows.HKEY_CURRENT_USER_LOCAL_SETTINGS
常量
HKEY
std.os.windows.HKEY_DYN_DATA
常量
HKEY
std.os.windows.HKEY_LOCAL_MACHINE
常量
HKEY
std.os.windows.HKEY_PERFORMANCE_DATA
常量
HKEY
std.os.windows.HKEY_PERFORMANCE_NLSTEXT
常量
HKEY
std.os.windows.HKEY_PERFORMANCE_TEXT
常量
HKEY
std.os.windows.HKEY_USERS
常量
HKEY
std.os.windows.HMENU
类型
std.os.windows.HMODULE
类型
std.os.windows.HWND
类型
std.os.windows.IMAGE_TLS_DIRECTORY
容器
字段
StartAddressOfRawData: usize
EndAddressOfRawData: usize
AddressOfIndex: usize
AddressOfCallBacks: usize
SizeOfZeroFill: u32
Characteristics: u32
std.os.windows.IMAGE_TLS_DIRECTORY32
别名
std.os.windows.IMAGE_TLS_DIRECTORY64
别名
std.os.windows.INIT_ONCE
别名
std.os.windows.INIT_ONCE_FN
类型
std.os.windows.INIT_ONCE_STATIC_INIT
别名
std.os.windows.INT
类型
std.os.windows.INVALID_FILE_ATTRIBUTES
常量
DWORD
std.os.windows.INVALID_HANDLE_VALUE
常量
HANDLE
std.os.windows.Io
别名
别名目标 std.Io
std.os.windows.IO_APC_ROUTINE
常量
std.os.windows.IO_REPARSE_TAG
容器
字段
Value: u12
Index: u4 = 0
ReservedBits: u12 = 0
IsDirectory: bool = false若为目录则可具有子项。
IsSurrogate: bool = false表示系统中的另一个命名实体。
IsReserved: bool = false对于非 Microsoft 标签,必须为 false。
IsMicrosoft: bool = false归 Microsoft 所有。
RESERVED_INVALIDMOUNT_POINTHSMDRIVE_EXTENDERHSM2SISWIMCSVDFSFILTER_MANAGERSYMLINKIIS_CACHEDFSRDEDUPAPPXSTRMNFSFILE_PLACEHOLDERDFMWOFWCIGLOBAL_REPARSECLOUDAPPEXECLINKPROJFSLX_SYMLINKSTORAGE_SYNCWCI_TOMBSTONEUNHANDLEDONEDRIVEPROJFS_TOMBSTONEAF_UNIXLX_FIFOLX_CHRLX_BLKLX_STORAGE_SYNC_FOLDERWCI_LINKDATALESS_CIM
std.os.windows.IO_REPARSE_TAG.AF_UNIX
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.APPEXECLINK
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.APPXSTRM
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.CLOUD
函数
pub inline fn CLOUD(index: u4) IO_REPARSE_TAG
参数
index: u4
std.os.windows.IO_REPARSE_TAG.CSV
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DATALESS_CIM
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DEDUP
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DFM
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DFS
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DFSR
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.DRIVE_EXTENDER
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.FILE_PLACEHOLDER
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.FILTER_MANAGER
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.GLOBAL_REPARSE
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.HSM
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.HSM2
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.IIS_CACHE
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.LX_BLK
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.LX_CHR
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.LX_FIFO
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.LX_STORAGE_SYNC_FOLDER
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.LX_SYMLINK
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.MOUNT_POINT
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.NFS
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.ONEDRIVE
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.PROJFS
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.PROJFS_TOMBSTONE
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.RESERVED_INVALID
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.SIS
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.STORAGE_SYNC
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.SYMLINK
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.UNHANDLED
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.WCI
函数
pub inline fn WCI(index: u1) IO_REPARSE_TAG
参数
index: u1
std.os.windows.IO_REPARSE_TAG.WCI_LINK
函数
pub inline fn WCI_LINK(index: u1) IO_REPARSE_TAG
参数
index: u1
std.os.windows.IO_REPARSE_TAG.WCI_TOMBSTONE
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.WIM
常量
IO_REPARSE_TAG
std.os.windows.IO_REPARSE_TAG.WOF
常量
IO_REPARSE_TAG
std.os.windows.IO_STATUS_BLOCK
容器
字段
std.os.windows.IOCTL
命名空间
std.os.windows.IOCTL.AFD
命名空间
CONTROL_CODEBINDCONNECTSTART_LISTENWAIT_FOR_LISTENACCEPTRECEIVERECEIVE_DATAGRAMSENDSEND_DATAGRAMPOLLPARTIAL_DISCONNECTGET_ADDRESSQUERY_RECEIVE_INFOQUERY_HANDLESSET_INFORMATIONGET_CONTEXT_LENGTHGET_CONTEXTSET_CONTEXTSET_CONNECT_DATASET_CONNECT_OPTIONSSET_DISCONNECT_DATASET_DISCONNECT_OPTIONSGET_CONNECT_DATAGET_CONNECT_OPTIONSGET_DISCONNECT_DATAGET_DISCONNECT_OPTIONSSIZE_CONNECT_DATASIZE_CONNECT_OPTIONSSIZE_DISCONNECT_DATASIZE_DISCONNECT_OPTIONSGET_INFORMATIONTRANSMIT_FILESUPER_ACCEPTEVENT_SELECTENUM_NETWORK_EVENTSDEFER_ACCEPTWAIT_FOR_LISTEN_LIFOSET_QOSGET_QOSNO_OPERATIONVALIDATE_GROUPGET_UNACCEPTED_CONNECT_DATAQUEUE_APCSOCKOPTSUPER_CONNECTRECV_MSGRIO
std.os.windows.IOCTL.AFD.ACCEPT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.BIND
常量
CTL_CODE
std.os.windows.IOCTL.AFD.CONNECT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.CONTROL_CODE
容器
字段
std.os.windows.IOCTL.AFD.DEFER_ACCEPT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.ENUM_NETWORK_EVENTS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.EVENT_SELECT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_ADDRESS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_CONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_CONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_CONTEXT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_CONTEXT_LENGTH
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_DISCONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_DISCONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_INFORMATION
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_QOS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.GET_UNACCEPTED_CONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.NO_OPERATION
常量
CTL_CODE
std.os.windows.IOCTL.AFD.PARTIAL_DISCONNECT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.POLL
常量
CTL_CODE
std.os.windows.IOCTL.AFD.QUERY_HANDLES
常量
CTL_CODE
std.os.windows.IOCTL.AFD.QUERY_RECEIVE_INFO
常量
CTL_CODE
std.os.windows.IOCTL.AFD.QUEUE_APC
常量
CTL_CODE
std.os.windows.IOCTL.AFD.RECEIVE
常量
CTL_CODE
std.os.windows.IOCTL.AFD.RECEIVE_DATAGRAM
常量
CTL_CODE
std.os.windows.IOCTL.AFD.RECV_MSG
常量
CTL_CODE
std.os.windows.IOCTL.AFD.RIO
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SEND
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SEND_DATAGRAM
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_CONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_CONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_CONTEXT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_DISCONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_DISCONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_INFORMATION
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SET_QOS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SIZE_CONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SIZE_CONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SIZE_DISCONNECT_DATA
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SIZE_DISCONNECT_OPTIONS
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SOCKOPT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.START_LISTEN
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SUPER_ACCEPT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.SUPER_CONNECT
常量
CTL_CODE
std.os.windows.IOCTL.AFD.TRANSMIT_FILE
常量
CTL_CODE
std.os.windows.IOCTL.AFD.VALIDATE_GROUP
常量
CTL_CODE
std.os.windows.IOCTL.AFD.WAIT_FOR_LISTEN
常量
CTL_CODE
std.os.windows.IOCTL.AFD.WAIT_FOR_LISTEN_LIFO
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV
命名空间
std.os.windows.IOCTL.CONDRV.ALLOW_VIA_UIACCESS
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.COMPLETE_IO
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.DISCONNECT_PIPE
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.GET_DISPLAY_SIZE
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.GET_FONT_SIZE
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.GET_SERVER_PID
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.ISSUE_USER_IO
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.LAUNCH_SERVER
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.READ_INPUT
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.READ_IO
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.SET_CURSOR
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.SET_SERVER_INFORMATION
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.UPDATE_DISPLAY
常量
CTL_CODE
std.os.windows.IOCTL.CONDRV.WRITE_OUTPUT
常量
CTL_CODE
std.os.windows.IOCTL.KSEC
命名空间
std.os.windows.IOCTL.KSEC.GEN_RANDOM
常量
CTL_CODE
std.os.windows.IOCTL.MOUNTMGR
命名空间
std.os.windows.IOCTL.MOUNTMGR.QUERY_DOS_VOLUME_PATH
常量
CTL_CODE
std.os.windows.IOCTL.MOUNTMGR.QUERY_POINTS
常量
CTL_CODE
std.os.windows.IsProcessorFeaturePresent
函数
pub fn IsProcessorFeaturePresent(feature: PF) bool
参数
feature: PF
std.os.windows.KAFFINITY
类型
std.os.windows.KERNEL_USER_TIMES
容器
字段
CreationTime: LARGE_INTEGER
ExitTime: LARGE_INTEGER
KernelTime: LARGE_INTEGER
UserTime: LARGE_INTEGER
std.os.windows.kernel32
别名
std.os.windows.KEY
命名空间
std.os.windows.KEY.VALUE
命名空间
std.os.windows.KEY.VALUE.INFORMATION_CLASS
容器
字段
Basic = 0
Full = 1
Partial = 2
FullAlign64 = 3
PartialAlign64 = 4
Layer = 5
_
std.os.windows.KEY.VALUE.INFORMATION_CLASS.Max
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.KEY.VALUE.PARTIAL_INFORMATION
容器
字段
std.os.windows.KEY.VALUE.PARTIAL_INFORMATION.data
函数
pub fn data(info: *const PARTIAL_INFORMATION) []const UCHAR
参数
info: *const PARTIAL_INFORMATION
std.os.windows.KNONVOLATILE_CONTEXT_POINTERS
类型
std.os.windows.KPRIORITY
类型
std.os.windows.KSYSTEM_TIME
容器
字段
std.os.windows.KUSER_SHARED_DATA
容器
共享内核用户数据
字段
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
别名
别名目标 std.os.windows.lang
std.os.windows.LANGID
类型
std.os.windows.LARGE_INTEGER
类型
std.os.windows.LDR
命名空间
std.os.windows.LDR.DATA_TABLE_ENTRY
容器
微软对此的文档不完整,此处字段取自多个资料,包括:
字段
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
命名空间
std.os.windows.LDR.DLL_NOTIFICATION.COOKIE
类型
std.os.windows.LDR.DLL_NOTIFICATION.DATA
容器
字段
std.os.windows.LDR.DLL_NOTIFICATION.DATA.LOADED
容器
字段
Flags: REGISTER
FullDllName: *const UNICODE_STRING
BaseDllName: *const UNICODE_STRING
DllBase: PVOID
SizeOfImage: ULONG
std.os.windows.LDR.DLL_NOTIFICATION.DATA.UNLOADED
容器
字段
Flags: REGISTER
FullDllName: *const UNICODE_STRING
BaseDllName: *const UNICODE_STRING
DllBase: PVOID
SizeOfImage: ULONG
std.os.windows.LDR.DLL_NOTIFICATION.FUNCTION
常量
std.os.windows.LDR.DLL_NOTIFICATION.REASON
容器
字段
LOADED = 1
UNLOADED = 2
std.os.windows.LDR.DLL_NOTIFICATION.REGISTER
容器
字段
Reserved0: u32 = 0
std.os.windows.LDR.GET_DLL_HANDLE_EX
容器
字段
UNCHANGED_REFCOUNT: bool = false
PIN: bool = false
Reserved2: u30 = 0
std.os.windows.LDR.GET_PROCEDURE_ADDRESS
容器
字段
DONT_RECORD_FORWARDER: bool = false
Reserved1: u31 = 0
std.os.windows.LDR.LOAD
容器
字段
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
容器
字段
Flink: *LIST_ENTRY
Blink: *LIST_ENTRY
std.os.windows.LOGICAL
别名
别名目标 std.os.windows.ULONG
std.os.windows.LONG
类型
std.os.windows.LONG_PTR
类型
std.os.windows.LONGLONG
类型
std.os.windows.LPARAM
别名
std.os.windows.LPCSTR
类型
std.os.windows.LPCTSTR
常量
std.os.windows.LPCVOID
类型
std.os.windows.LPCWSTR
类型
std.os.windows.LPSTR
类型
std.os.windows.LPTSTR
常量
std.os.windows.LPVOID
类型
std.os.windows.LPWSTR
类型
std.os.windows.LSTATUS
别名
别名目标 std.os.windows.LONG
std.os.windows.M128A
类型
std.os.windows.MAKELANGID
函数
inline fn MAKELANGID(p: c_ushort, s: c_ushort) LANGID
参数
p: c_ushort
s: c_ushort
std.os.windows.math
别名
别名目标 std.math
std.os.windows.MAX_PATH
常量
std.os.windows.MAX_WOW64_SHARED_ENTRIES
常量
std.os.windows.MAXIMUM_REPARSE_DATA_BUFFER_SIZE
常量
ULONG
std.os.windows.MAXIMUM_XSTATE_FEATURES
常量
std.os.windows.maxInt
别名
别名目标 std.math.maxInt
std.os.windows.mem
别名
别名目标 std.mem
std.os.windows.MEM
命名空间
std.os.windows.MEM.ALLOCATE
容器
字段
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"
常量
ALLOCATE
std.os.windows.MEM.EXTENDED_PARAMETER
容器
字段
std.os.windows.MEM.EXTENDED_PARAMETER.TYPE
容器
字段
InvalidType = 0
AddressRequirements
NumaNode
PartitionHandle
UserPhysicalHandle
AttributeFlags
ImageMachine
_
std.os.windows.MEM.EXTENDED_PARAMETER.TYPE.Max
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.MEM.FREE
容器
字段
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
容器
字段
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
容器
字段
WITH_TRANSIENT_BOOST: bool = false
PRESERVE_PLACEHOLDER: bool = false
Reserved2: u30 = 0
std.os.windows.MEMORY_RANGE_ENTRY
容器
字段
std.os.windows.MODULEINFO
容器
字段
std.os.windows.MOUNT_POINT_REPARSE_BUFFER
容器
字段
std.os.windows.MOUNTMGR_MOUNT_POINT
容器
字段
std.os.windows.MOUNTMGR_MOUNT_POINTS
容器
字段
std.os.windows.MOUNTMGR_TARGET_NAME
容器
字段
std.os.windows.MOUNTMGR_VOLUME_PATHS
容器
字段
std.os.windows.NAME_MAX
常量
[每个文件名组成部分的长度]最多可达 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
常量
std.os.windows.NEON128
类型
std.os.windows.NET
命名空间
std.os.windows.NET.IFINDEX
容器
字段
_
std.os.windows.NET.LUID
容器
字段
Reserved: u24 = 0
Index: u24
IfType: u16
std.os.windows.nls
别名
别名目标 std.os.windows.nls
std.os.windows.normalizePath
函数
通过以下步骤规范化 Windows 路径:
- 将所有正斜杠转换为反斜杠
- 合并重复的反斜杠
- 移除“.”和“..”目录部分 返回新路径的长度。
pub fn normalizePath(comptime T: type, path: []T) RemoveDotDirsError!usize
参数
T: type
path: []T
错误
- TooManyParentDirs
std.os.windows.NT_PRODUCT_TYPE
容器
字段
NtProductWinNt = 1
NtProductLanManNt
NtProductServer
std.os.windows.NT_TIB
容器
字段
std.os.windows.ntdll
别名
别名目标 std.os.windows.ntdll
std.os.windows.NTSTATUS
别名
std.os.windows.ntToWin32Namespace
函数
类似于 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
命名空间
std.os.windows.OBJECT.ATTRIBUTES
容器
字段
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
容器
字段
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
常量
ATTRIBUTES
std.os.windows.OBJECT.BASIC_INFORMATION
容器
字段
Attributes: ATTRIBUTES.Flags
GrantedAccess: ACCESS_MASK
HandleCount: ULONG
PointerCount: ULONG
Reserved: [10]ULONG
std.os.windows.OBJECT.HANDLE_FLAG
容器
字段
INHERIT: bool = false
PROTECT_FROM_CLOSE: bool = false
Reserved1: u14 = 0
std.os.windows.OBJECT.INFORMATION_CLASS
容器
字段
Basic = 0
Name = 1
Type = 2
Types = 3
HandleFlag = 4
Session = 5
_
std.os.windows.OBJECT.INFORMATION_CLASS.Max
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.OBJECT.NAME_INFORMATION
容器
字段
Name: UNICODE_STRING
std.os.windows.OSVERSIONINFOW
容器
字段
std.os.windows.PAGE
容器
字段
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
函数
pub fn fromProtection(protection: std.process.MemoryProtection) ?PAGE
参数
protection: std.process.MemoryProtection
std.os.windows.PATH_MAX_WIDE
常量
路径最大长度 32,767 字符只是近似值,因为“\?\” 前缀可能在运行时被系统扩展成更长的字符串, 且扩展后的长度计入总长度。 来自 https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file#maximum-path-length-limitation
std.os.windows.PCTSTR
常量
std.os.windows.PCWSTR
类型
std.os.windows.peb
函数
pub fn peb() *PEB
std.os.windows.PEB
容器
进程环境块 微软对此的文档不完整,此处字段来自多种资料,包括:
字段
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
容器
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
容器
此结构体的具体细节未知,但实验和对 kernelbase.dll 的逆向分析 确认偏移 8 处存在一个字段。
字段
unknown: u64
base_static_server_data_addr: u64位于 CSRSS 地址空间。
std.os.windows.peb.zig_windows_peb
函数
这是 C 后端的临时规避措施,直到 zig 能够将 C 代码放入内联汇编。
extern fn zig_windows_peb() callconv(.c) *anyopaque
std.os.windows.PF
容器
处理器特性枚举。
字段
FLOATING_POINT_PRECISION_ERRATA = 0在 Pentium 上,极少数情况下会发生浮点精度错误。
FLOATING_POINT_EMULATED = 1使用软件模拟器模拟浮点运算。 若浮点运算被模拟,则此函数返回非零值;否则返回零。
COMPARE_EXCHANGE_DOUBLE = 2支持原子比较并交换操作(cmpxchg)。
MMX_INSTRUCTIONS_AVAILABLE = 3MMX 指令集可用。
PPC_MOVEMEM_64BIT_OK = 4
ALPHA_BYTE_INSTRUCTIONS = 5
XMMI_INSTRUCTIONS_AVAILABLE = 6可使用 SSE 指令集。
@"3DNOW_INSTRUCTIONS_AVAILABLE" = 73D-Now 指令可用。
RDTSC_INSTRUCTION_AVAILABLE = 8RDTSC 指令可用。
PAE_ENABLED = 9处理器已启用 PAE。
XMMI64_INSTRUCTIONS_AVAILABLE = 10SSE2 指令集可用。
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 = 22RDFSBASE、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 = 36SSSE3 指令集可用。
SSE4_1_INSTRUCTIONS_AVAILABLE = 37SSE4_1 指令集可用。
SSE4_2_INSTRUCTIONS_AVAILABLE = 38可使用 SSE4_2 指令集。
AVX_INSTRUCTIONS_AVAILABLE = 39AVX 指令集可用。
AVX2_INSTRUCTIONS_AVAILABLE = 40AVX2 指令集可用。
AVX512F_INSTRUCTIONS_AVAILABLE = 41AVX512F 指令集可用。
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
类型
std.os.windows.PPS_POST_PROCESS_INIT_ROUTINE
类型
std.os.windows.PROC
类型
std.os.windows.PROCESS
命名空间
std.os.windows.PROCESS.BASIC_INFORMATION
容器
字段
std.os.windows.PROCESS.INFOCLASS
容器
字段
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
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.PROCESS.INFORMATION
容器
字段
std.os.windows.PROCESS.VM_COUNTERS
容器
字段
std.os.windows.PROCESSOR_FEATURE_MAX
常量
std.os.windows.PS
命名空间
std.os.windows.PS.ATTRIBUTE
容器
字段
std.os.windows.PS.ATTRIBUTE.LIST
容器
字段
std.os.windows.PS.ATTRIBUTE.NUM
容器
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
容器
字段
TEB_ADDRESS = construct(.TebAddress, true, false, false)
_
std.os.windows.PS.ATTRIBUTE.Type.construct
函数
pub fn construct(num: NUM, thread: bool, input: bool, additive: bool) ULONG_PTR
参数
std.os.windows.PTSTR
常量
std.os.windows.PVOID
类型
std.os.windows.PWSTR
类型
std.os.windows.REG
命名空间
REG_ 命名空间非常拥挤,Windows 头文件中有很多相互重叠且无关的 定义,因此此处不严格照搬 Windows 头文件名称, 而是添加额外命名空间以提高可读性。
std.os.windows.REG.LoadOptions
容器
与 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
容器
与 NtOpenKeyEx 配合使用,或许也用于其他调用
字段
Reserved0: u2 = 0
BACKUP_RESTORE: bool = false为备份或还原而打开 特殊访问规则需要相应特权
OPEN_LINK: bool = false打开符号链接
Reserved3: u28 = 0
std.os.windows.REG.ValueType
容器
字段
NONE = 0无值类型
SZ = 1以空字符终止的 Unicode 字符串
EXPAND_SZ = 2以空字符结尾的 Unicode 字符串(包含环境变量引用)。
BINARY = 3自由形式的二进制数据
DWORD = 432 位数
DWORD_BIG_ENDIAN = 532 位数
LINK = 6符号链接(Unicode)
MULTI_SZ = 7多个 Unicode 字符串
RESOURCE_LIST = 8资源映射中的资源列表
FULL_RESOURCE_DESCRIPTOR = 9硬件描述中的资源列表
RESOURCE_REQUIREMENTS_LIST = 10
QWORD = 1164 位数字
_
std.os.windows.REG.ValueType.DWORD_LITTLE_ENDIAN
常量
32 位数值(等同于 REG_DWORD)
ValueType
std.os.windows.REG.ValueType.QWORD_LITTLE_ENDIAN
常量
64 位数(同 REG_QWORD)
ValueType
std.os.windows.REGSAM
别名
std.os.windows.relocateCsrssAddress
函数
接受共享内存区域在 CSRSS 地址空间映射视图中的地址, 返回该共享内存区域在本进程映射视图中的对应地址。
fn relocateCsrssAddress(addr: u64) *const anyopaque
参数
addr: u64
std.os.windows.RemoveDotDirsError
错误集合
removeDotDirsSanitized 的错误类型
错误
- TooManyParentDirs
std.os.windows.removeDotDirsSanitized
函数
从“已清理的相对路径”中移除点和双点路径分量。 “已清理路径”指: 1)所有正斜杠均已替换为反斜杠; 2)所有重复反斜杠均已合并; 3)路径为相对路径,即不以反斜杠开头。
pub fn removeDotDirsSanitized(comptime T: type, path: []T) RemoveDotDirsError!usize
参数
T: type
path: []T
错误
- TooManyParentDirs
std.os.windows.REPARSE_DATA_BUFFER
容器
字段
std.os.windows.RTL_BITMAP
容器
std.os.windows.RTL_CRITICAL_SECTION
容器
字段
std.os.windows.RTL_CRITICAL_SECTION_DEBUG
容器
字段
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
容器
字段
std.os.windows.RTL_OSVERSIONINFOW
别名
std.os.windows.RTL_QUERY_REGISTRY_DELETE
常量
用于在查询后删除值键。
std.os.windows.RTL_QUERY_REGISTRY_DIRECT
常量
忽略 QueryRoutine 字段。EntryContext 字段指向存储值的位置。 对于以空字符结尾的字符串,EntryContext 指向 UNICODE_STRING 结构体, 描述缓冲区的最大大小。如果 .Buffer 字段为 NULL,则 分配缓冲区。
std.os.windows.RTL_QUERY_REGISTRY_NOEXPAND
常量
用于禁止将 REG_MULTI_SZ 展开为多次回调, 或阻止展开 REG_EXPAND_SZ 中的环境变量值。
std.os.windows.RTL_QUERY_REGISTRY_NOVALUE
常量
标记没有值名称的表项,仅要求一次回调, 而非枚举全部值。
std.os.windows.RTL_QUERY_REGISTRY_REQUIRED
常量
若未找到与此表条目匹配的项则失败。
std.os.windows.RTL_QUERY_REGISTRY_ROUTINE
类型
std.os.windows.RTL_QUERY_REGISTRY_SUBKEY
常量
Name 是子键;表中剩余部分或直到下一个子键之前的内容, 是要在该子键中查找的值名。
std.os.windows.RTL_QUERY_REGISTRY_TABLE
容器
字段
std.os.windows.RTL_QUERY_REGISTRY_TOPKEY
常量
将此表条目及所有后续条目的当前键重置为原始键。
std.os.windows.RTL_QUERY_REGISTRY_TYPECHECK
常量
将此标志与 RTL_QUERY_REGISTRY_DIRECT 标志组合,验证存储的注册表值的 REG_XXX 类型是否与调用者预期类型一致。 若不匹配,则调用失败。
std.os.windows.RTL_REGISTRY_ABSOLUTE
常量
路径是完整路径
std.os.windows.RTL_REGISTRY_CONTROL
常量
\Registry\Machine\System\CurrentControlSet\Control
std.os.windows.RTL_REGISTRY_DEVICEMAP
常量
\Registry\Machine\Hardware\DeviceMap
std.os.windows.RTL_REGISTRY_HANDLE
常量
低位存储注册表句柄
std.os.windows.RTL_REGISTRY_MAXIMUM
常量
std.os.windows.RTL_REGISTRY_OPTIONAL
常量
表示键节点为可选
std.os.windows.RTL_REGISTRY_SERVICES
常量
\Registry\Machine\System\CurrentControlSet\Services
std.os.windows.RTL_REGISTRY_USER
常量
\Registry\User\CurrentUser
std.os.windows.RTL_REGISTRY_WINDOWS_NT
常量
\Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion
std.os.windows.RTL_RUN_ONCE
容器
字段
Ptr: ?*anyopaque
std.os.windows.RTL_RUN_ONCE_INIT
常量
std.os.windows.RTL_USER_PROCESS_PARAMETERS
容器
字段
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
类型
std.os.windows.SEC
容器
字段
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
常量
SEC
std.os.windows.SECTION_INHERIT
容器
字段
Share = 1
Unmap = 2
std.os.windows.SECURITY_ATTRIBUTES
容器
字段
std.os.windows.SHORT
类型
std.os.windows.SIZE_T
类型
std.os.windows.SRWLOCK
容器
字段
Ptr: ?PVOID = null
std.os.windows.SRWLOCK_INIT
常量
std.os.windows.STARTF_FORCEOFFFEEDBACK
常量
std.os.windows.STARTF_FORCEONFEEDBACK
常量
std.os.windows.STARTF_PREVENTPINNING
常量
std.os.windows.STARTF_RUNFULLSCREEN
常量
std.os.windows.STARTF_TITLEISAPPID
常量
std.os.windows.STARTF_TITLEISLINKNAME
常量
std.os.windows.STARTF_UNTRUSTEDSOURCE
常量
std.os.windows.STARTF_USECOUNTCHARS
常量
std.os.windows.STARTF_USEFILLATTRIBUTE
常量
std.os.windows.STARTF_USEHOTKEY
常量
std.os.windows.STARTF_USEPOSITION
常量
std.os.windows.STARTF_USESHOWWINDOW
常量
std.os.windows.STARTF_USESIZE
常量
std.os.windows.STARTF_USESTDHANDLES
常量
std.os.windows.STARTUPINFOW
容器
字段
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
函数
pub fn statusBug(status: NTSTATUS) UnexpectedError
参数
status: NTSTATUS
std.os.windows.std
别名
别名目标 std
std.os.windows.STRING
类型函数
fn STRING(comptime C: type) type
参数
C: type
字段
std.os.windows.STRING.empty
常量
@This()
std.os.windows.STRING.init
函数
pub fn init(string: []const C) @This()
参数
string: []const C
std.os.windows.STRING.initZ
函数
pub fn initZ(string: [:0]const C) @This()
参数
string: [:0]const C
std.os.windows.STRING.isEmpty
函数
pub fn isEmpty(string: *const @This()) bool
参数
string: *const @This()
std.os.windows.STRING.slice
函数
pub fn slice(string: *const @This()) []C
参数
string: *const @This()
std.os.windows.STRING.sliceZ
函数
pub fn sliceZ(string: *const @This()) [:0]C
参数
string: *const @This()
std.os.windows.SUBLANG
别名
std.os.windows.SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE
常量
DWORD
std.os.windows.SYMBOLIC_LINK_FLAG_DIRECTORY
常量
DWORD
std.os.windows.SYMBOLIC_LINK_REPARSE_BUFFER
容器
字段
std.os.windows.SYMLINK_FLAG_RELATIVE
常量
ULONG
std.os.windows.SYSTEM
命名空间
std.os.windows.SYSTEM.BASIC_INFORMATION
容器
字段
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
容器
字段
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
常量
std.os.windows.TDI
命名空间
std.os.windows.TDI.ADDRESS
命名空间
std.os.windows.TDI.ADDRESS.IP
容器
字段
std.os.windows.TDI.ADDRESS.IP6
容器
字段
std.os.windows.TDI.ADDRESS.TYPE
容器
字段
UNSPEC = 0未指定
UNIX = 1主机本地(管道、门户,
IP = 2网际互连:UDP、TCP 等。
IMPLINK = 3arpanet imp 地址
PUP = 4PUP 协议,例如 BSP
CHAOS = 5MIT CHAOS 协议
NS = 6XEROX NS 协议
IPX = 6Netware IPX
NBS = 7NBS 协议
ECMA = 8欧洲计算机制造商
DATAKIT = 9datakit 协议
CCITT = 10CCITT 协议,如 X.25 等
SNA = 11IBM SNA
DECnet = 12DECnet
DLI = 13直接数据链路接口
LAT = 14LAT
HYLINK = 15NSC Hyperchannel
APPLETALK = 16AppleTalk
NETBIOS = 17Netbios 地址
@"8022" = 18
OSI_TSAP = 19
NETONE = 20用于 WzMail
VNS = 21Banyan VINES IP
NETBIOS_EX = 22NETBIOS 地址扩展
IP6 = 23IP 版本 6
NETBIOS_UNICODE_EX = 24WCHAR Netbios 地址
_
std.os.windows.TDI.CONNECTION
命名空间
std.os.windows.TDI.CONNECTION.CONTEXT
别名
别名目标 std.os.windows.PVOID
std.os.windows.TDI.CONNECTION.INFORMATION
容器
字段
std.os.windows.TDI.RECEIVE
容器
字段
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
容器
字段
std.os.windows.TDI.REQUEST.ACCEPT
容器
字段
Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION
std.os.windows.TDI.REQUEST.ASSOCIATE
容器
字段
std.os.windows.TDI.REQUEST.CONNECT
容器
字段
Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION
Timeout: LARGE_INTEGER
std.os.windows.TDI.REQUEST.DISCONNECT
容器
字段
Request: REQUEST
Timeout: LARGE_INTEGER
std.os.windows.TDI.REQUEST.LISTEN
容器
字段
Request: REQUEST
RequestConnectionInformation: *CONNECTION.INFORMATION
ReturnConnectionInformation: *CONNECTION.INFORMATION
ListenFlags: USHORT
std.os.windows.TDI.REQUEST.RECEIVE
容器
字段
std.os.windows.TDI.REQUEST.SEND
容器
字段
std.os.windows.TDI.REQUEST.SEND_DATAGRAM
容器
字段
Request: REQUEST
SendDatagramInformation: *CONNECTION.INFORMATION
std.os.windows.TDI.REQUEST.STATUS
容器
字段
std.os.windows.TDI.SEND
容器
字段
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
别名
std.os.windows.teb
函数
pub fn teb() *TEB
std.os.windows.TEB
容器
字段
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
函数
这是 C 后端的临时规避措施,直到 zig 能够将 C 代码放入内联汇编。
extern fn zig_windows_teb() callconv(.c) *anyopaque
std.os.windows.testEqlIgnoreCase
函数
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
命名空间
std.os.windows.THREAD_START_ROUTINE
常量
std.os.windows.THREAD.BASIC_INFORMATION
容器
字段
std.os.windows.THREAD.CREATE_FLAGS
容器
字段
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
常量
CREATE_FLAGS
std.os.windows.THREAD.INFOCLASS
容器
字段
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
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.THREAD.StackSize
容器
字段
default = 0可执行文件头部指定的默认大小
_
std.os.windows.TIMER_TYPE
容器
字段
Notification
Synchronization
std.os.windows.TLS_OUT_OF_INDEXES
常量
std.os.windows.toSysTime
函数
pub fn toSysTime(ns: Io.Timestamp) i64
参数
std.os.windows.toUpperWtf16
函数
Windows 上且不在编译期时使用 RtlUpcaseUnicodeChar, 避免包含冗余的大写字符数据副本。
pub inline fn toUpperWtf16(c: u16) u16
参数
c: u16
std.os.windows.UCHAR
类型
std.os.windows.UINT
类型
std.os.windows.ULARGE_INTEGER
类型
std.os.windows.ULONG
类型
std.os.windows.ULONG_PTR
类型
std.os.windows.ULONG64
类型
std.os.windows.ULONGLONG
类型
std.os.windows.unexpectedError
函数
调用 Windows DLL 或其他会设置 SetLastError 的函数后, 遇到意外错误时调用此函数。
pub fn unexpectedError(err: Win32Error) UnexpectedError
参数
err: Win32Error
std.os.windows.UnexpectedError
别名
std.os.windows.unexpectedStatus
函数
调用 Windows NtDll 后得到意外状态时,调用此函数。
pub fn unexpectedStatus(status: NTSTATUS) UnexpectedError
参数
status: NTSTATUS
std.os.windows.UNICODE_STRING
类型
std.os.windows.UNW_FLAG_CHAININFO
常量
std.os.windows.UNW_FLAG_EHANDLER
常量
std.os.windows.UNW_FLAG_NHANDLER
常量
std.os.windows.UNW_FLAG_UHANDLER
常量
std.os.windows.UNWIND_HISTORY_TABLE
容器
字段
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
容器
字段
ImageBase: ULONG64
FunctionEntry: *RUNTIME_FUNCTION
std.os.windows.UNWIND_HISTORY_TABLE_SIZE
常量
std.os.windows.USER_THREAD_START_ROUTINE
常量
std.os.windows.USHORT
类型
std.os.windows.va_list
类型
std.os.windows.VECTORED_EXCEPTION_HANDLER
类型
std.os.windows.VIRTUAL_MEMORY
命名空间
std.os.windows.VIRTUAL_MEMORY.INFORMATION_CLASS
容器
字段
Prefetch = 0
PagePriority = 1
CfgCallTarget = 2
PageDirtyState = 3
ImageHotPatch = 4
PhysicalContiguity = 5
VirtualMachinePrepopulate = 6
RemoveFromWorkingSet = 7
_
std.os.windows.VIRTUAL_MEMORY.INFORMATION_CLASS.Max
常量
@typeInfo(@This()).@"enum".tag_type
std.os.windows.VIRTUAL_MEMORY.MEMORY_PREFETCH_INFORMATION
容器
字段
Flags: VM_PREFETCH
std.os.windows.VIRTUAL_MEMORY.MEMORY_PREFETCH_INFORMATION.VM_PREFETCH
容器
字段
TO_WORKING_SET: boolWindows 11 24H4 引入。 尝试将指定的一个或多个地址范围放入进程工作集,即将页面载入物理内存。
Reserved1: u31 = 0
std.os.windows.WAIT_TYPE
容器
字段
All
Any
std.os.windows.WCHAR
类型
std.os.windows.Win32Error
别名
std.os.windows.WORD
类型
std.os.windows.ws2_32
别名
std.os.windows.wtf8ToWtf16Le
函数
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
类型
std.os.windows.XSTATE_CONFIGURATION
容器
字段
EnabledFeatures: ULONG64
Size: ULONG
OptimizedSave: ULONG
Features: [MAXIMUM_XSTATE_FEATURES]XSTATE_FEATURE
std.os.windows.XSTATE_FEATURE
容器
字段
源码
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;
}