3 * Wine server protocol definition
5 * Copyright (C
) 2001 Alexandre Julliard
7 * This file is used by tools
/make_requests to build the
8 * protocol structures in include
/wine
/server_protocol.h
10 * This library is free software
; you can redistribute it and
/or
11 * modify it under the terms of the GNU Lesser General Public
12 * License as published by the Free Software Foundation
; either
13 * version
2.1 of the License
, or (at your option
) any later version.
15 * This library is distributed in the hope that it will be useful
,
16 * but WITHOUT ANY WARRANTY
; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU
18 * Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public
21 * License along with this library
; if not
, write to the Free Software
22 * Foundation
, Inc.
, 51 Franklin St
, Fifth Floor
, Boston
, MA
02110-1301, USA
25 @HEADER
/* start of C declarations
*/
34 typedef unsigned int obj_handle_t
;
35 typedef unsigned int user_handle_t
;
36 typedef unsigned int atom_t
;
37 typedef unsigned int process_id_t
;
38 typedef unsigned int thread_id_t
;
39 typedef unsigned int data_size_t
;
40 typedef unsigned int ioctl_code_t
;
41 typedef unsigned __int64 lparam_t
;
42 typedef unsigned __int64 apc_param_t
;
43 typedef unsigned __int64 mem_size_t
;
44 typedef unsigned __int64 file_pos_t
;
45 typedef unsigned __int64 client_ptr_t
;
46 typedef unsigned __int64 affinity_t
;
47 typedef client_ptr_t mod_handle_t
;
51 int req
; /* request code
*/
52 data_size_t request_size
; /* request variable part size
*/
53 data_size_t reply_size
; /* reply variable part maximum size
*/
58 unsigned int error
; /* error result
*/
59 data_size_t reply_size
; /* reply variable part size
*/
62 /* placeholder structure for the maximum allowed request size
*/
63 /* this is used to construct the generic_request union
*/
64 struct request_max_size
66 int pad
[16]; /* the max request size is
16 ints
*/
69 #define FIRST_USER_HANDLE
0x0020 /* first possible value for low word of user handle
*/
70 #define LAST_USER_HANDLE
0xffef /* last possible value for low word of user handle
*/
73 /* debug event data
*/
76 int code
; /* event code
*/
79 int code
; /* EXCEPTION_DEBUG_EVENT
*/
80 int first
; /* first chance exception?
*/
81 unsigned int exc_code
; /* exception code
*/
82 unsigned int flags
; /* exception flags
*/
83 client_ptr_t record
; /* exception record
*/
84 client_ptr_t address
; /* exception address
*/
85 int nb_params
; /* number of parameters
*/
87 client_ptr_t params
[15]; /* parameters
*/
91 int code
; /* CREATE_THREAD_DEBUG_EVENT
*/
92 obj_handle_t handle
; /* handle to the new thread
*/
93 client_ptr_t teb
; /* thread
teb (in debugged process address space
) */
94 client_ptr_t start
; /* thread startup routine
*/
98 int code
; /* CREATE_PROCESS_DEBUG_EVENT
*/
99 obj_handle_t file
; /* handle to the process exe file
*/
100 obj_handle_t process
; /* handle to the new process
*/
101 obj_handle_t thread
; /* handle to the new thread
*/
102 mod_handle_t base
; /* base of executable image
*/
103 int dbg_offset
; /* offset of debug info in file
*/
104 int dbg_size
; /* size of debug info
*/
105 client_ptr_t teb
; /* thread
teb (in debugged process address space
) */
106 client_ptr_t start
; /* thread startup routine
*/
107 client_ptr_t name
; /* image
name (optional
) */
108 int unicode
; /* is it Unicode?
*/
112 int code
; /* EXIT_THREAD_DEBUG_EVENT
/EXIT_PROCESS_DEBUG_EVENT
*/
113 int exit_code
; /* thread or process exit code
*/
117 int code
; /* LOAD_DLL_DEBUG_EVENT
*/
118 obj_handle_t handle
; /* file handle for the dll
*/
119 mod_handle_t base
; /* base address of the dll
*/
120 int dbg_offset
; /* offset of debug info in file
*/
121 int dbg_size
; /* size of debug info
*/
122 client_ptr_t name
; /* image
name (optional
) */
123 int unicode
; /* is it Unicode?
*/
127 int code
; /* UNLOAD_DLL_DEBUG_EVENT
*/
129 mod_handle_t base
; /* base address of the dll
*/
133 /* supported CPU types
*/
136 CPU_x86
, CPU_x86_64
, CPU_POWERPC
, CPU_ARM
, CPU_ARM64
138 typedef int cpu_type_t
;
143 cpu_type_t cpu
; /* cpu type
*/
144 unsigned int flags
; /* SERVER_CTX_
* flags
*/
147 struct
{ unsigned int eip
, ebp
, esp
, eflags
, cs
, ss
; } i386_regs
;
148 struct
{ unsigned __int64 rip
, rbp
, rsp
;
149 unsigned int cs
, ss
, flags
, __pad
; } x86_64_regs
;
150 struct
{ unsigned int iar
, msr
, ctr
, lr
, dar
, dsisr
, trap
, __pad
; } powerpc_regs
;
151 struct
{ unsigned int sp
, lr
, pc
, cpsr
; } arm_regs
;
152 struct
{ unsigned __int64 sp
, pc
, pstate
; } arm64_regs
;
153 } ctl
; /* selected by SERVER_CTX_CONTROL
*/
156 struct
{ unsigned int eax
, ebx
, ecx
, edx
, esi
, edi
; } i386_regs
;
157 struct
{ unsigned __int64 rax
,rbx
, rcx
, rdx
, rsi
, rdi
,
158 r8
, r9
, r10
, r11
, r12
, r13
, r14
, r15
; } x86_64_regs
;
159 struct
{ unsigned int gpr
[32], cr
, xer
; } powerpc_regs
;
160 struct
{ unsigned int r
[13]; } arm_regs
;
161 struct
{ unsigned __int64 x
[31]; } arm64_regs
;
162 } integer
; /* selected by SERVER_CTX_INTEGER
*/
165 struct
{ unsigned int ds
, es
, fs
, gs
; } i386_regs
;
166 struct
{ unsigned int ds
, es
, fs
, gs
; } x86_64_regs
;
167 } seg
; /* selected by SERVER_CTX_SEGMENTS
*/
170 struct
{ unsigned int ctrl
, status
, tag
, err_off
, err_sel
, data_off
, data_sel
, cr0npx
;
171 unsigned char regs
[80]; } i386_regs
;
172 struct
{ struct
{ unsigned __int64 low
, high
; } fpregs
[32]; } x86_64_regs
;
173 struct
{ double fpr
[32], fpscr
; } powerpc_regs
;
174 } fp
; /* selected by SERVER_CTX_FLOATING_POINT
*/
177 struct
{ unsigned int dr0
, dr1
, dr2
, dr3
, dr6
, dr7
; } i386_regs
;
178 struct
{ unsigned __int64 dr0
, dr1
, dr2
, dr3
, dr6
, dr7
; } x86_64_regs
;
179 struct
{ unsigned int dr
[8]; } powerpc_regs
;
180 } debug
; /* selected by SERVER_CTX_DEBUG_REGISTERS
*/
183 unsigned char i386_regs
[512];
184 } ext
; /* selected by SERVER_CTX_EXTENDED_REGISTERS
*/
187 #define SERVER_CTX_CONTROL
0x01
188 #define SERVER_CTX_INTEGER
0x02
189 #define SERVER_CTX_SEGMENTS
0x04
190 #define SERVER_CTX_FLOATING_POINT
0x08
191 #define SERVER_CTX_DEBUG_REGISTERS
0x10
192 #define SERVER_CTX_EXTENDED_REGISTERS
0x20
194 /* structure used in sending an fd from client to server
*/
197 thread_id_t tid
; /* thread id
*/
198 int fd
; /* file descriptor on client
-side
*/
201 /* structure sent by the server on the wait fifo
*/
204 client_ptr_t cookie
; /* magic cookie that was passed in select_request
*/
205 int signaled
; /* wait result
*/
209 /* NT
-style timeout
, in
100ns units
, negative means relative timeout
*/
210 typedef __int64 timeout_t
;
211 #define
TIMEOUT_INFINITE (((timeout_t
)0x7fffffff) << 32 |
0xffffffff)
213 /* structure for process startup info
*/
216 unsigned int debug_flags
;
217 unsigned int console_flags
;
218 obj_handle_t console
;
220 obj_handle_t hstdout
;
221 obj_handle_t hstderr
;
228 unsigned int attribute
;
231 data_size_t curdir_len
;
232 data_size_t dllpath_len
;
233 data_size_t imagepath_len
;
234 data_size_t cmdline_len
;
235 data_size_t title_len
;
236 data_size_t desktop_len
;
237 data_size_t shellinfo_len
;
238 data_size_t runtime_len
;
239 /* VARARG(curdir
,unicode_str
,curdir_len
); */
240 /* VARARG(dllpath
,unicode_str
,dllpath_len
); */
241 /* VARARG(imagepath
,unicode_str
,imagepath_len
); */
242 /* VARARG(cmdline
,unicode_str
,cmdline_len
); */
243 /* VARARG(title
,unicode_str
,title_len
); */
244 /* VARARG(desktop
,unicode_str
,desktop_len
); */
245 /* VARARG(shellinfo
,unicode_str
,shellinfo_len
); */
246 /* VARARG(runtime
,unicode_str
,runtime_len
); */
249 /* structure returned in the list of window properties
*/
252 atom_t atom
; /* property atom
*/
253 int string
; /* was atom a string originally?
*/
254 lparam_t data
; /* data stored in property
*/
257 /* structure to specify window rectangles
*/
266 /* structure for parameters of async I
/O calls
*/
269 obj_handle_t handle
; /* object to perform I
/O on
*/
270 obj_handle_t event
; /* event to signal when done
*/
271 client_ptr_t callback
; /* client
-side callback to call upon end of async
*/
272 client_ptr_t iosb
; /* I
/O status block in client addr space
*/
273 client_ptr_t arg
; /* opaque user data to pass to callback
*/
274 apc_param_t cvalue
; /* completion value to use for completion events
*/
277 /* structures for extra message data
*/
279 struct hardware_msg_data
281 lparam_t info
; /* extra info
*/
282 unsigned int hw_id
; /* unique id
*/
283 unsigned int flags
; /* hook flags
*/
289 int type
; /* RIM_TYPEKEYBOARD
*/
290 unsigned int message
; /* message generated by this rawinput event
*/
291 unsigned short vkey
; /* virtual key code
*/
292 unsigned short scan
; /* scan code
*/
296 int type
; /* RIM_TYPEMOUSE
*/
297 int x
; /* x coordinate
*/
298 int y
; /* y coordinate
*/
299 unsigned int data
; /* mouse data
*/
304 struct callback_msg_data
306 client_ptr_t callback
; /* callback function
*/
307 lparam_t data
; /* user data for callback
*/
308 lparam_t result
; /* message result
*/
311 struct winevent_msg_data
313 user_handle_t hook
; /* hook handle
*/
314 thread_id_t tid
; /* thread id
*/
315 client_ptr_t hook_proc
; /* hook proc address
*/
316 /* followed by module name if any
*/
324 int type
; /* INPUT_KEYBOARD
*/
325 unsigned short vkey
; /* virtual key code
*/
326 unsigned short scan
; /* scan code
*/
327 unsigned int flags
; /* event flags
*/
328 unsigned int time
; /* event time
*/
329 lparam_t info
; /* extra info
*/
333 int type
; /* INPUT_MOUSE
*/
334 int x
; /* coordinates
*/
336 unsigned int data
; /* mouse data
*/
337 unsigned int flags
; /* event flags
*/
338 unsigned int time
; /* event time
*/
339 lparam_t info
; /* extra info
*/
343 int type
; /* INPUT_HARDWARE
*/
344 unsigned int msg
; /* message code
*/
345 lparam_t lparam
; /* message param
*/
351 unsigned char bytes
[1]; /* raw data for sent messages
*/
352 struct hardware_msg_data hardware
;
353 struct callback_msg_data callback
;
354 struct winevent_msg_data winevent
;
357 /* structure for console char
/attribute info
*/
364 /* structure returned in filesystem events
*/
365 struct filesystem_event
374 unsigned int low_part
;
378 #define MAX_ACL_LEN
65535
380 struct security_descriptor
382 unsigned int control
; /* SE_ flags
*/
383 data_size_t owner_len
;
384 data_size_t group_len
;
385 data_size_t sacl_len
;
386 data_size_t dacl_len
;
387 /* VARARG(owner
,SID
); */
388 /* VARARG(group
,SID
); */
389 /* VARARG(sacl
,ACL
); */
390 /* VARARG(dacl
,ACL
); */
393 struct object_attributes
395 obj_handle_t rootdir
; /* root directory
*/
396 unsigned int attributes
; /* object attributes
*/
397 data_size_t sd_len
; /* length of security_descriptor data. may be
0 */
398 data_size_t name_len
; /* length of the name string. may be
0 */
399 /* VARARG(sd
,security_descriptor
); */
400 /* VARARG(name
,unicode_str
); */
406 /* unsigned int attributes
[count
]; */
407 /* VARARG(sids
,SID
); */
415 SELECT_SIGNAL_AND_WAIT
,
416 SELECT_KEYED_EVENT_WAIT
,
417 SELECT_KEYED_EVENT_RELEASE
425 enum select_op op
; /* SELECT_WAIT or SELECT_WAIT_ALL
*/
426 obj_handle_t handles
[MAXIMUM_WAIT_OBJECTS
];
430 enum select_op op
; /* SELECT_SIGNAL_AND_WAIT
*/
432 obj_handle_t signal
; /* must be last in the structure so we can remove it on retries
*/
436 enum select_op op
; /* SELECT_KEYED_EVENT_WAIT or SELECT_KEYED_EVENT_RELEASE
*/
465 enum apc_type type
; /* APC_USER
*/
467 client_ptr_t func
; /* void (__stdcall
*func
)(ULONG_PTR
,ULONG_PTR
,ULONG_PTR
); */
468 apc_param_t args
[3]; /* arguments for user function
*/
472 enum apc_type type
; /* APC_TIMER
*/
474 client_ptr_t func
; /* void (__stdcall
*func
)(void
*, unsigned int
, unsigned int
); */
475 timeout_t time
; /* absolute time of expiration
*/
476 client_ptr_t arg
; /* user argument
*/
480 enum apc_type type
; /* APC_ASYNC_IO
*/
481 unsigned int status
; /* I
/O status
*/
482 client_ptr_t func
; /* unsigned
int (*func)(void*, void*, unsigned int, void**, void**); */
483 client_ptr_t user
; /* user pointer
*/
484 client_ptr_t sb
; /* status block
*/
488 enum apc_type type
; /* APC_VIRTUAL_ALLOC
*/
489 unsigned int op_type
; /* type of operation
*/
490 client_ptr_t addr
; /* requested address
*/
491 mem_size_t size
; /* allocation size
*/
492 unsigned int zero_bits
; /* allocation alignment
*/
493 unsigned int prot
; /* memory protection flags
*/
497 enum apc_type type
; /* APC_VIRTUAL_FREE
*/
498 unsigned int op_type
; /* type of operation
*/
499 client_ptr_t addr
; /* requested address
*/
500 mem_size_t size
; /* allocation size
*/
504 enum apc_type type
; /* APC_VIRTUAL_QUERY
*/
506 client_ptr_t addr
; /* requested address
*/
510 enum apc_type type
; /* APC_VIRTUAL_PROTECT
*/
511 unsigned int prot
; /* new protection flags
*/
512 client_ptr_t addr
; /* requested address
*/
513 mem_size_t size
; /* requested size
*/
517 enum apc_type type
; /* APC_VIRTUAL_FLUSH
*/
519 client_ptr_t addr
; /* requested address
*/
520 mem_size_t size
; /* requested size
*/
524 enum apc_type type
; /* APC_VIRTUAL_LOCK
*/
526 client_ptr_t addr
; /* requested address
*/
527 mem_size_t size
; /* requested size
*/
531 enum apc_type type
; /* APC_VIRTUAL_UNLOCK
*/
533 client_ptr_t addr
; /* requested address
*/
534 mem_size_t size
; /* requested size
*/
538 enum apc_type type
; /* APC_MAP_VIEW
*/
539 obj_handle_t handle
; /* mapping handle
*/
540 client_ptr_t addr
; /* requested address
*/
541 mem_size_t size
; /* allocation size
*/
542 file_pos_t offset
; /* file offset
*/
543 unsigned int alloc_type
;/* allocation type
*/
544 unsigned short zero_bits
; /* allocation alignment
*/
545 unsigned short prot
; /* memory protection flags
*/
549 enum apc_type type
; /* APC_UNMAP_VIEW
*/
551 client_ptr_t addr
; /* view address
*/
555 enum apc_type type
; /* APC_CREATE_THREAD
*/
556 int suspend
; /* suspended thread?
*/
557 client_ptr_t func
; /* void (__stdcall
*func
)(void*)
; start function
*/
558 client_ptr_t arg
; /* argument for start function
*/
559 mem_size_t reserve
; /* reserve size for thread stack
*/
560 mem_size_t commit
; /* commit size for thread stack
*/
569 enum apc_type type
; /* APC_ASYNC_IO
*/
570 unsigned int status
; /* new status of async operation
*/
571 client_ptr_t apc
; /* user APC to call
*/
572 client_ptr_t arg
; /* user APC argument
*/
573 unsigned int total
; /* bytes transferred
*/
577 enum apc_type type
; /* APC_VIRTUAL_ALLOC
*/
578 unsigned int status
; /* status returned by call
*/
579 client_ptr_t addr
; /* resulting address
*/
580 mem_size_t size
; /* resulting size
*/
584 enum apc_type type
; /* APC_VIRTUAL_FREE
*/
585 unsigned int status
; /* status returned by call
*/
586 client_ptr_t addr
; /* resulting address
*/
587 mem_size_t size
; /* resulting size
*/
591 enum apc_type type
; /* APC_VIRTUAL_QUERY
*/
592 unsigned int status
; /* status returned by call
*/
593 client_ptr_t base
; /* resulting base address
*/
594 client_ptr_t alloc_base
;/* resulting allocation base
*/
595 mem_size_t size
; /* resulting region size
*/
596 unsigned short state
; /* resulting region state
*/
597 unsigned short prot
; /* resulting region protection
*/
598 unsigned short alloc_prot
;/* resulting allocation protection
*/
599 unsigned short alloc_type
;/* resulting region allocation type
*/
603 enum apc_type type
; /* APC_VIRTUAL_PROTECT
*/
604 unsigned int status
; /* status returned by call
*/
605 client_ptr_t addr
; /* resulting address
*/
606 mem_size_t size
; /* resulting size
*/
607 unsigned int prot
; /* old protection flags
*/
611 enum apc_type type
; /* APC_VIRTUAL_FLUSH
*/
612 unsigned int status
; /* status returned by call
*/
613 client_ptr_t addr
; /* resulting address
*/
614 mem_size_t size
; /* resulting size
*/
618 enum apc_type type
; /* APC_VIRTUAL_LOCK
*/
619 unsigned int status
; /* status returned by call
*/
620 client_ptr_t addr
; /* resulting address
*/
621 mem_size_t size
; /* resulting size
*/
625 enum apc_type type
; /* APC_VIRTUAL_UNLOCK
*/
626 unsigned int status
; /* status returned by call
*/
627 client_ptr_t addr
; /* resulting address
*/
628 mem_size_t size
; /* resulting size
*/
632 enum apc_type type
; /* APC_MAP_VIEW
*/
633 unsigned int status
; /* status returned by call
*/
634 client_ptr_t addr
; /* resulting address
*/
635 mem_size_t size
; /* resulting size
*/
639 enum apc_type type
; /* APC_MAP_VIEW
*/
640 unsigned int status
; /* status returned by call
*/
644 enum apc_type type
; /* APC_CREATE_THREAD
*/
645 unsigned int status
; /* status returned by call
*/
646 thread_id_t tid
; /* thread id
*/
647 obj_handle_t handle
; /* handle to new thread
*/
653 unsigned int major
; /* irp major function
*/
656 unsigned int major
; /* IRP_MJ_CREATE
*/
657 unsigned int access
; /* access rights
*/
658 unsigned int sharing
; /* sharing flags
*/
659 unsigned int options
; /* file options
*/
660 client_ptr_t device
; /* opaque ptr for the device
*/
664 unsigned int major
; /* IRP_MJ_CLOSE
*/
666 client_ptr_t file
; /* opaque ptr for the file object
*/
670 unsigned int major
; /* IRP_MJ_READ
*/
671 unsigned int key
; /* driver key
*/
672 client_ptr_t file
; /* opaque ptr for the file object
*/
673 file_pos_t pos
; /* file position
*/
677 unsigned int major
; /* IRP_MJ_WRITE
*/
678 unsigned int key
; /* driver key
*/
679 client_ptr_t file
; /* opaque ptr for the file object
*/
680 file_pos_t pos
; /* file position
*/
684 unsigned int major
; /* IRP_MJ_FLUSH_BUFFERS
*/
686 client_ptr_t file
; /* opaque ptr for the file object
*/
690 unsigned int major
; /* IRP_MJ_DEVICE_CONTROL
*/
691 ioctl_code_t code
; /* ioctl code
*/
692 client_ptr_t file
; /* opaque ptr for the file object
*/
696 /* information about a PE image mapping
, roughly equivalent to SECTION_IMAGE_INFORMATION
*/
700 client_ptr_t entry_point
;
702 mem_size_t stack_size
;
703 mem_size_t stack_commit
;
704 unsigned int zerobits
;
705 unsigned int subsystem
;
706 unsigned short subsystem_low
;
707 unsigned short subsystem_high
;
709 unsigned short image_charact
;
710 unsigned short dll_charact
;
711 unsigned short machine
;
712 unsigned char contains_code
;
713 unsigned char image_flags
;
714 unsigned int loader_flags
;
715 unsigned int header_size
;
716 unsigned int file_size
;
717 unsigned int checksum
;
720 struct rawinput_device
722 unsigned short usage_page
;
723 unsigned short usage
;
725 user_handle_t target
;
728 /****************************************************************/
729 /* Request declarations
*/
731 /* Create a new process from the context of the parent
*/
733 int inherit_all
; /* inherit all handles from parent
*/
734 unsigned int create_flags
; /* creation flags
*/
735 int socket_fd
; /* file descriptor for process socket
*/
736 obj_handle_t exe_file
; /* file handle for main exe
*/
737 unsigned int process_access
; /* access rights for process object
*/
738 unsigned int process_attr
; /* attributes for process object
*/
739 unsigned int thread_access
; /* access rights for thread object
*/
740 unsigned int thread_attr
; /* attributes for thread object
*/
741 cpu_type_t cpu
; /* CPU that the new process will use
*/
742 data_size_t info_size
; /* size of startup info
*/
743 VARARG(info
,startup_info
,info_size
); /* startup information
*/
744 VARARG(env
,unicode_str
); /* environment for new process
*/
746 obj_handle_t info
; /* new process info handle
*/
747 process_id_t pid
; /* process id
*/
748 obj_handle_t phandle
; /* process
handle (in the current process
) */
749 thread_id_t tid
; /* thread id
*/
750 obj_handle_t thandle
; /* thread
handle (in the current process
) */
754 /* Retrieve information about a newly started process
*/
755 @
REQ(get_new_process_info
)
756 obj_handle_t info
; /* info handle returned from new_process_request
*/
758 int success
; /* did the process start successfully?
*/
759 int exit_code
; /* process exit code if failed
*/
763 /* Create a new thread from the context of the parent
*/
765 unsigned int access
; /* wanted access rights
*/
766 unsigned int attributes
; /* object attributes
*/
767 int suspend
; /* new thread should be suspended on creation
*/
768 int request_fd
; /* fd for request pipe
*/
770 thread_id_t tid
; /* thread id
*/
771 obj_handle_t handle
; /* thread
handle (in the current process
) */
775 /* Retrieve the new process startup info
*/
776 @
REQ(get_startup_info
)
778 obj_handle_t exe_file
; /* file handle for main exe
*/
779 data_size_t info_size
; /* size of startup info
*/
780 VARARG(info
,startup_info
,info_size
); /* startup information
*/
781 VARARG(env
,unicode_str
); /* environment
*/
785 /* Signal the end of the process initialization
*/
786 @
REQ(init_process_done
)
787 int gui
; /* is it a GUI process?
*/
788 mod_handle_t module
; /* main module base address
*/
789 client_ptr_t ldt_copy
; /* address of LDT
copy (in thread address space
) */
790 client_ptr_t entry
; /* process entry point
*/
794 /* Initialize a thread
; called from the child after
fork()/clone() */
796 int unix_pid
; /* Unix pid of new thread
*/
797 int unix_tid
; /* Unix tid of new thread
*/
798 int debug_level
; /* new debug level
*/
799 client_ptr_t teb
; /* TEB of new
thread (in thread address space
) */
800 client_ptr_t entry
; /* entry point or PEB if initial
thread (in thread address space
) */
801 int reply_fd
; /* fd for reply pipe
*/
802 int wait_fd
; /* fd for blocking calls pipe
*/
803 cpu_type_t cpu
; /* CPU that this thread is running on
*/
805 process_id_t pid
; /* process id of the new thread
's process */
806 thread_id_t tid; /* thread id of the new thread */
807 timeout_t server_start; /* server start time */
808 data_size_t info_size; /* total size of startup info */
809 int version; /* protocol version */
810 unsigned int all_cpus; /* bitset of supported CPUs */
814 /* Terminate a process */
815 @REQ(terminate_process)
816 obj_handle_t handle; /* process handle to terminate */
817 int exit_code; /* process exit code */
819 int self; /* suicide? */
823 /* Terminate a thread */
824 @REQ(terminate_thread)
825 obj_handle_t handle; /* thread handle to terminate */
826 int exit_code; /* thread exit code */
828 int self; /* suicide? */
829 int last; /* last thread in this process? */
833 /* Retrieve information about a process */
834 @REQ(get_process_info)
835 obj_handle_t handle; /* process handle */
837 process_id_t pid; /* server process id */
838 process_id_t ppid; /* server process id of parent */
839 affinity_t affinity; /* process affinity mask */
840 client_ptr_t peb; /* PEB address in process address space */
841 timeout_t start_time; /* process start time */
842 timeout_t end_time; /* process end time */
843 int exit_code; /* process exit code */
844 int priority; /* priority class */
845 cpu_type_t cpu; /* CPU that this process is running on */
846 short int debugger_present; /* process is being debugged */
847 short int debug_children; /* inherit debugger to child processes */
851 /* Set a process information */
852 @REQ(set_process_info)
853 obj_handle_t handle; /* process handle */
854 int mask; /* setting mask (see below) */
855 int priority; /* priority class */
856 affinity_t affinity; /* affinity mask */
858 #define SET_PROCESS_INFO_PRIORITY 0x01
859 #define SET_PROCESS_INFO_AFFINITY 0x02
862 /* Retrieve information about a thread */
863 @REQ(get_thread_info)
864 obj_handle_t handle; /* thread handle */
865 thread_id_t tid_in; /* thread id (optional) */
867 process_id_t pid; /* server process id */
868 thread_id_t tid; /* server thread id */
869 client_ptr_t teb; /* thread teb pointer */
870 client_ptr_t entry_point; /* thread entry point */
871 affinity_t affinity; /* thread affinity mask */
872 int exit_code; /* thread exit code */
873 int priority; /* thread priority level */
874 int last; /* last thread in process */
878 /* Retrieve information about thread times */
879 @REQ(get_thread_times)
880 obj_handle_t handle; /* thread handle */
882 timeout_t creation_time; /* thread creation time */
883 timeout_t exit_time; /* thread exit time */
887 /* Set a thread information */
888 @REQ(set_thread_info)
889 obj_handle_t handle; /* thread handle */
890 int mask; /* setting mask (see below) */
891 int priority; /* priority class */
892 affinity_t affinity; /* affinity mask */
893 client_ptr_t entry_point; /* thread entry point */
894 obj_handle_t token; /* impersonation token */
896 #define SET_THREAD_INFO_PRIORITY 0x01
897 #define SET_THREAD_INFO_AFFINITY 0x02
898 #define SET_THREAD_INFO_TOKEN 0x04
899 #define SET_THREAD_INFO_ENTRYPOINT 0x08
902 /* Retrieve information about a module */
904 obj_handle_t handle; /* process handle */
905 mod_handle_t base_address; /* base address of module */
907 client_ptr_t entry_point;
908 data_size_t size; /* module size */
909 data_size_t filename_len; /* buffer len in bytes required to store filename */
910 VARARG(filename,unicode_str); /* file name of module */
914 /* Suspend a thread */
916 obj_handle_t handle; /* thread handle */
918 int count; /* new suspend count */
922 /* Resume a thread */
924 obj_handle_t handle; /* thread handle */
926 int count; /* new suspend count */
930 /* Notify the server that a dll has been loaded */
932 obj_handle_t mapping; /* file mapping handle */
933 mod_handle_t base; /* base address */
934 client_ptr_t name; /* ptr to ptr to name (in process addr space) */
935 data_size_t size; /* dll size */
936 int dbg_offset; /* debug info offset */
937 int dbg_size; /* debug info size */
938 VARARG(filename,unicode_str); /* file name of dll */
942 /* Notify the server that a dll is being unloaded */
944 mod_handle_t base; /* base address */
948 /* Queue an APC for a thread or process */
950 obj_handle_t handle; /* thread or process handle */
951 apc_call_t call; /* call arguments */
953 obj_handle_t handle; /* APC handle */
954 int self; /* run APC in caller itself? */
958 /* Get the result of an APC call */
960 obj_handle_t handle; /* handle to the APC */
962 apc_result_t result; /* result of the APC */
966 /* Close a handle for the current process */
968 obj_handle_t handle; /* handle to close */
972 /* Set a handle information */
973 @REQ(set_handle_info)
974 obj_handle_t handle; /* handle we are interested in */
975 int flags; /* new handle flags */
976 int mask; /* mask for flags to set */
978 int old_flags; /* old flag value */
982 /* Duplicate a handle */
984 obj_handle_t src_process; /* src process handle */
985 obj_handle_t src_handle; /* src handle to duplicate */
986 obj_handle_t dst_process; /* dst process handle */
987 unsigned int access; /* wanted access rights */
988 unsigned int attributes; /* object attributes */
989 unsigned int options; /* duplicate options (see below) */
991 obj_handle_t handle; /* duplicated handle in dst process */
992 int self; /* is the source the current process? */
993 int closed; /* whether the source handle has been closed */
995 #define DUP_HANDLE_CLOSE_SOURCE DUPLICATE_CLOSE_SOURCE
996 #define DUP_HANDLE_SAME_ACCESS DUPLICATE_SAME_ACCESS
997 #define DUP_HANDLE_MAKE_GLOBAL 0x80000000 /* Not a Windows flag */
1000 /* Open a handle to a process */
1002 process_id_t pid; /* process id to open */
1003 unsigned int access; /* wanted access rights */
1004 unsigned int attributes; /* object attributes */
1006 obj_handle_t handle; /* handle to the process */
1010 /* Open a handle to a thread */
1012 thread_id_t tid; /* thread id to open */
1013 unsigned int access; /* wanted access rights */
1014 unsigned int attributes; /* object attributes */
1016 obj_handle_t handle; /* handle to the thread */
1020 /* Wait for handles */
1022 int flags; /* wait flags (see below) */
1023 client_ptr_t cookie; /* magic cookie to return to client */
1024 timeout_t timeout; /* timeout */
1025 obj_handle_t prev_apc; /* handle to previous APC */
1026 VARARG(result,apc_result); /* result of previous APC */
1027 VARARG(data,select_op); /* operation-specific data */
1029 timeout_t timeout; /* timeout converted to absolute */
1030 apc_call_t call; /* APC call arguments */
1031 obj_handle_t apc_handle; /* handle to next APC */
1033 #define SELECT_ALERTABLE 1
1034 #define SELECT_INTERRUPTIBLE 2
1037 /* Create an event */
1039 unsigned int access; /* wanted access rights */
1040 int manual_reset; /* manual reset event */
1041 int initial_state; /* initial state of the event */
1042 VARARG(objattr,object_attributes); /* object attributes */
1044 obj_handle_t handle; /* handle to the event */
1047 /* Event operation */
1049 obj_handle_t handle; /* handle to event */
1050 int op; /* event operation (see below) */
1052 enum event_op { PULSE_EVENT, SET_EVENT, RESET_EVENT };
1055 obj_handle_t handle; /* handle to event */
1057 int manual_reset; /* manual reset event */
1058 int state; /* current state of the event */
1063 unsigned int access; /* wanted access rights */
1064 unsigned int attributes; /* object attributes */
1065 obj_handle_t rootdir; /* root directory */
1066 VARARG(name,unicode_str); /* object name */
1068 obj_handle_t handle; /* handle to the event */
1072 /* Create a keyed event */
1073 @REQ(create_keyed_event)
1074 unsigned int access; /* wanted access rights */
1075 VARARG(objattr,object_attributes); /* object attributes */
1077 obj_handle_t handle; /* handle to the event */
1080 /* Open a keyed event */
1081 @REQ(open_keyed_event)
1082 unsigned int access; /* wanted access rights */
1083 unsigned int attributes; /* object attributes */
1084 obj_handle_t rootdir; /* root directory */
1085 VARARG(name,unicode_str); /* object name */
1087 obj_handle_t handle; /* handle to the event */
1091 /* Create a mutex */
1093 unsigned int access; /* wanted access rights */
1094 int owned; /* initially owned? */
1095 VARARG(objattr,object_attributes); /* object attributes */
1097 obj_handle_t handle; /* handle to the mutex */
1101 /* Release a mutex */
1103 obj_handle_t handle; /* handle to the mutex */
1105 unsigned int prev_count; /* value of internal counter, before release */
1111 unsigned int access; /* wanted access rights */
1112 unsigned int attributes; /* object attributes */
1113 obj_handle_t rootdir; /* root directory */
1114 VARARG(name,unicode_str); /* object name */
1116 obj_handle_t handle; /* handle to the mutex */
1122 obj_handle_t handle; /* handle to mutex */
1124 unsigned int count; /* current count of mutex */
1125 int owned; /* true if owned by current thread */
1126 int abandoned; /* true if abandoned */
1130 /* Create a semaphore */
1131 @REQ(create_semaphore)
1132 unsigned int access; /* wanted access rights */
1133 unsigned int initial; /* initial count */
1134 unsigned int max; /* maximum count */
1135 VARARG(objattr,object_attributes); /* object attributes */
1137 obj_handle_t handle; /* handle to the semaphore */
1141 /* Release a semaphore */
1142 @REQ(release_semaphore)
1143 obj_handle_t handle; /* handle to the semaphore */
1144 unsigned int count; /* count to add to semaphore */
1146 unsigned int prev_count; /* previous semaphore count */
1149 @REQ(query_semaphore)
1150 obj_handle_t handle; /* handle to the semaphore */
1152 unsigned int current; /* current count */
1153 unsigned int max; /* maximum count */
1156 /* Open a semaphore */
1157 @REQ(open_semaphore)
1158 unsigned int access; /* wanted access rights */
1159 unsigned int attributes; /* object attributes */
1160 obj_handle_t rootdir; /* root directory */
1161 VARARG(name,unicode_str); /* object name */
1163 obj_handle_t handle; /* handle to the semaphore */
1169 unsigned int access; /* wanted access rights */
1170 unsigned int sharing; /* sharing flags */
1171 int create; /* file create action */
1172 unsigned int options; /* file options */
1173 unsigned int attrs; /* file attributes for creation */
1174 VARARG(objattr,object_attributes); /* object attributes */
1175 VARARG(filename,string); /* file name */
1177 obj_handle_t handle; /* handle to the file */
1181 /* Open a file object */
1182 @REQ(open_file_object)
1183 unsigned int access; /* wanted access rights */
1184 unsigned int attributes; /* open attributes */
1185 obj_handle_t rootdir; /* root directory */
1186 unsigned int sharing; /* sharing flags */
1187 unsigned int options; /* file options */
1188 VARARG(filename,unicode_str); /* file name */
1190 obj_handle_t handle; /* handle to the file */
1194 /* Allocate a file handle for a Unix fd */
1195 @REQ(alloc_file_handle)
1196 unsigned int access; /* wanted access rights */
1197 unsigned int attributes; /* object attributes */
1198 int fd; /* file descriptor on the client side */
1200 obj_handle_t handle; /* handle to the file */
1204 /* Get the Unix name from a file handle */
1205 @REQ(get_handle_unix_name)
1206 obj_handle_t handle; /* file handle */
1208 data_size_t name_len; /* unix name length */
1209 VARARG(name,string); /* unix name */
1213 /* Get a Unix fd to access a file */
1215 obj_handle_t handle; /* handle to the file */
1217 int type; /* file type (see below) */
1218 int cacheable; /* can fd be cached in the client? */
1219 unsigned int access; /* file access rights */
1220 unsigned int options; /* file open options */
1224 FD_TYPE_INVALID, /* invalid file (no associated fd) */
1225 FD_TYPE_FILE, /* regular file */
1226 FD_TYPE_DIR, /* directory */
1227 FD_TYPE_SOCKET, /* socket */
1228 FD_TYPE_SERIAL, /* serial port */
1229 FD_TYPE_PIPE, /* named pipe */
1230 FD_TYPE_MAILSLOT, /* mailslot */
1231 FD_TYPE_CHAR, /* unspecified char device */
1232 FD_TYPE_DEVICE, /* Windows device file */
1237 /* Retrieve (or allocate) the client-side directory cache entry */
1238 @REQ(get_directory_cache_entry)
1239 obj_handle_t handle; /* handle to the directory */
1241 int entry; /* cache entry on the client side */
1242 VARARG(free,ints); /* entries that can be freed */
1246 /* Flush a file buffers */
1248 int blocking; /* whether it's a blocking flush
*/
1249 async_data_t async
; /* async I
/O parameters
*/
1251 obj_handle_t event
; /* event set when finished
*/
1255 /* Lock a region of a file
*/
1257 obj_handle_t handle
; /* handle to the file
*/
1258 file_pos_t offset
; /* offset of start of lock
*/
1259 file_pos_t count
; /* count of bytes to lock
*/
1260 int shared
; /* shared or exclusive lock?
*/
1261 int wait
; /* do we want to wait?
*/
1263 obj_handle_t handle
; /* handle to wait on
*/
1264 int overlapped
; /* is it an overlapped I
/O handle?
*/
1268 /* Unlock a region of a file
*/
1270 obj_handle_t handle
; /* handle to the file
*/
1271 file_pos_t offset
; /* offset of start of unlock
*/
1272 file_pos_t count
; /* count of bytes to unlock
*/
1276 /* Create a socket
*/
1278 unsigned int access
; /* wanted access rights
*/
1279 unsigned int attributes
; /* object attributes
*/
1280 int family
; /* family
, see socket manpage
*/
1281 int type
; /* type
, see socket manpage
*/
1282 int protocol
; /* protocol
, see socket manpage
*/
1283 unsigned int flags
; /* socket flags
*/
1285 obj_handle_t handle
; /* handle to the new socket
*/
1289 /* Accept a socket
*/
1291 obj_handle_t lhandle
; /* handle to the listening socket
*/
1292 unsigned int access
; /* wanted access rights
*/
1293 unsigned int attributes
; /* object attributes
*/
1295 obj_handle_t handle
; /* handle to the new socket
*/
1299 /* Accept into an initialized socket
*/
1300 @
REQ(accept_into_socket
)
1301 obj_handle_t lhandle
; /* handle to the listening socket
*/
1302 obj_handle_t ahandle
; /* handle to the accepting socket
*/
1306 /* Set socket event parameters
*/
1307 @
REQ(set_socket_event
)
1308 obj_handle_t handle
; /* handle to the socket
*/
1309 unsigned int mask
; /* event mask
*/
1310 obj_handle_t event
; /* event object
*/
1311 user_handle_t window
; /* window to send the message to
*/
1312 unsigned int msg
; /* message to send
*/
1316 /* Get socket event parameters
*/
1317 @
REQ(get_socket_event
)
1318 obj_handle_t handle
; /* handle to the socket
*/
1319 int service
; /* clear pending?
*/
1320 obj_handle_t c_event
; /* event to clear
*/
1322 unsigned int mask
; /* event mask
*/
1323 unsigned int pmask
; /* pending events
*/
1324 unsigned int state
; /* status bits
*/
1325 VARARG(errors
,ints
); /* event errors
*/
1329 /* Get socket info
*/
1330 @
REQ(get_socket_info
)
1331 obj_handle_t handle
; /* handle to the socket
*/
1333 int family
; /* family
, see socket manpage
*/
1334 int type
; /* type
, see socket manpage
*/
1335 int protocol
; /* protocol
, see socket manpage
*/
1339 /* Re
-enable pending socket events
*/
1340 @
REQ(enable_socket_event
)
1341 obj_handle_t handle
; /* handle to the socket
*/
1342 unsigned int mask
; /* events to re
-enable
*/
1343 unsigned int sstate
; /* status bits to set
*/
1344 unsigned int cstate
; /* status bits to clear
*/
1347 @
REQ(set_socket_deferred
)
1348 obj_handle_t handle
; /* handle to the socket
*/
1349 obj_handle_t deferred
; /* handle to the socket for which
accept() is deferred
*/
1352 /* Allocate a
console (only used by a console renderer
) */
1354 unsigned int access
; /* wanted access rights
*/
1355 unsigned int attributes
; /* object attributes
*/
1356 process_id_t pid
; /* pid of process which shall be attached to the console
*/
1357 int input_fd
; /* if pid
=-1 (bare console to current process
), fd for input
*/
1359 obj_handle_t handle_in
; /* handle to console input
*/
1360 obj_handle_t event
; /* handle to renderer events change notification
*/
1364 /* Free the console of the current process
*/
1369 #define CONSOLE_RENDERER_NONE_EVENT
0x00
1370 #define CONSOLE_RENDERER_TITLE_EVENT
0x01
1371 #define CONSOLE_RENDERER_ACTIVE_SB_EVENT
0x02
1372 #define CONSOLE_RENDERER_SB_RESIZE_EVENT
0x03
1373 #define CONSOLE_RENDERER_UPDATE_EVENT
0x04
1374 #define CONSOLE_RENDERER_CURSOR_POS_EVENT
0x05
1375 #define CONSOLE_RENDERER_CURSOR_GEOM_EVENT
0x06
1376 #define CONSOLE_RENDERER_DISPLAY_EVENT
0x07
1377 #define CONSOLE_RENDERER_EXIT_EVENT
0x08
1378 struct console_renderer_event
1413 /* retrieve console events for the renderer
*/
1414 @
REQ(get_console_renderer_events
)
1415 obj_handle_t handle
; /* handle to console input events
*/
1417 VARARG(data
,bytes
); /* the various console_renderer_events
*/
1421 /* Open a handle to the process console
*/
1423 obj_handle_t from
; /* 0 (resp
1) input (resp output
) of current process console
*/
1424 /* otherwise console_in handle to get active screen buffer?
*/
1425 unsigned int access
; /* wanted access rights
*/
1426 unsigned int attributes
; /* object attributes
*/
1427 int share
; /* share
mask (only for output handles
) */
1429 obj_handle_t handle
; /* handle to the console
*/
1433 /* Get the input queue wait event
*/
1434 @
REQ(get_console_wait_event
)
1436 obj_handle_t handle
;
1439 /* Get a console
mode (input or output
) */
1440 @
REQ(get_console_mode
)
1441 obj_handle_t handle
; /* handle to the console
*/
1443 int mode
; /* console mode
*/
1447 /* Set a console
mode (input or output
) */
1448 @
REQ(set_console_mode
)
1449 obj_handle_t handle
; /* handle to the console
*/
1450 int mode
; /* console mode
*/
1454 /* Set info about a
console (input only
) */
1455 @
REQ(set_console_input_info
)
1456 obj_handle_t handle
; /* handle to console input
, or
0 for process
' console */
1457 int mask; /* setting mask (see below) */
1458 obj_handle_t active_sb; /* active screen buffer */
1459 int history_mode; /* whether we duplicate lines in history */
1460 int history_size; /* number of lines in history */
1461 int edition_mode; /* index to the edition mode flavors */
1462 int input_cp; /* console input codepage */
1463 int output_cp; /* console output codepage */
1464 user_handle_t win; /* console window if backend supports it */
1465 VARARG(title,unicode_str); /* console title */
1467 #define SET_CONSOLE_INPUT_INFO_ACTIVE_SB 0x01
1468 #define SET_CONSOLE_INPUT_INFO_TITLE 0x02
1469 #define SET_CONSOLE_INPUT_INFO_HISTORY_MODE 0x04
1470 #define SET_CONSOLE_INPUT_INFO_HISTORY_SIZE 0x08
1471 #define SET_CONSOLE_INPUT_INFO_EDITION_MODE 0x10
1472 #define SET_CONSOLE_INPUT_INFO_INPUT_CODEPAGE 0x20
1473 #define SET_CONSOLE_INPUT_INFO_OUTPUT_CODEPAGE 0x40
1474 #define SET_CONSOLE_INPUT_INFO_WIN 0x80
1477 /* Get info about a console (input only) */
1478 @REQ(get_console_input_info)
1479 obj_handle_t handle; /* handle to console input, or 0 for process' console
*/
1481 int history_mode
; /* whether we duplicate lines in history
*/
1482 int history_size
; /* number of lines in history
*/
1483 int history_index
; /* number of used lines in history
*/
1484 int edition_mode
; /* index to the edition mode flavors
*/
1485 int input_cp
; /* console input codepage
*/
1486 int output_cp
; /* console output codepage
*/
1487 user_handle_t win
; /* console window if backend supports it
*/
1488 VARARG(title
,unicode_str
); /* console title
*/
1492 /* appends a string to console
's history */
1493 @REQ(append_console_input_history)
1494 obj_handle_t handle; /* handle to console input, or 0 for process' console
*/
1495 VARARG(line
,unicode_str
); /* line to add
*/
1499 /* appends a string to console
's history */
1500 @REQ(get_console_input_history)
1501 obj_handle_t handle; /* handle to console input, or 0 for process' console
*/
1502 int index
; /* index to get line from
*/
1504 int total
; /* total length of line in Unicode chars
*/
1505 VARARG(line
,unicode_str
); /* line to add
*/
1509 /* creates a new screen buffer on process
' console */
1510 @REQ(create_console_output)
1511 obj_handle_t handle_in; /* handle to console input, or 0 for process' console
*/
1512 unsigned int access
; /* wanted access rights
*/
1513 unsigned int attributes
; /* object attributes
*/
1514 unsigned int share
; /* sharing credentials
*/
1515 int fd
; /* for bare consoles
, fd the screen
-buffer is attached to
*/
1517 obj_handle_t handle_out
; /* handle to the screen buffer
*/
1521 /* Set info about a
console (output only
) */
1522 @
REQ(set_console_output_info
)
1523 obj_handle_t handle
; /* handle to the console
*/
1524 int mask
; /* setting
mask (see below
) */
1525 short int cursor_size
; /* size of
cursor (percentage filled
) */
1526 short int cursor_visible
;/* cursor visibility flag
*/
1527 short int cursor_x
; /* position of
cursor (x
, y
) */
1529 short int width
; /* width of the screen buffer
*/
1530 short int height
; /* height of the screen buffer
*/
1531 short int attr
; /* default fill
attributes (screen colors
) */
1532 short int popup_attr
; /* pop
-up color attributes
*/
1533 short int win_left
; /* window actually displayed by renderer
*/
1534 short int win_top
; /* the rect area is expressed within the
*/
1535 short int win_right
; /* boundaries of the screen buffer
*/
1536 short int win_bottom
;
1537 short int max_width
; /* maximum
size (width x height
) for the window
*/
1538 short int max_height
;
1539 short int font_width
; /* font
size (width x height
) */
1540 short int font_height
;
1541 VARARG(colors
,uints
); /* color table
*/
1543 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_GEOM
0x0001
1544 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_POS
0x0002
1545 #define SET_CONSOLE_OUTPUT_INFO_SIZE
0x0004
1546 #define SET_CONSOLE_OUTPUT_INFO_ATTR
0x0008
1547 #define SET_CONSOLE_OUTPUT_INFO_DISPLAY_WINDOW
0x0010
1548 #define SET_CONSOLE_OUTPUT_INFO_MAX_SIZE
0x0020
1549 #define SET_CONSOLE_OUTPUT_INFO_FONT
0x0040
1550 #define SET_CONSOLE_OUTPUT_INFO_COLORTABLE
0x0080
1551 #define SET_CONSOLE_OUTPUT_INFO_POPUP_ATTR
0x0100
1554 /* Get info about a
console (output only
) */
1555 @
REQ(get_console_output_info
)
1556 obj_handle_t handle
; /* handle to the console
*/
1558 short int cursor_size
; /* size of
cursor (percentage filled
) */
1559 short int cursor_visible
;/* cursor visibility flag
*/
1560 short int cursor_x
; /* position of
cursor (x
, y
) */
1562 short int width
; /* width of the screen buffer
*/
1563 short int height
; /* height of the screen buffer
*/
1564 short int attr
; /* default fill
attributes (screen colors
) */
1565 short int popup_attr
; /* pop
-up color attributes
*/
1566 short int win_left
; /* window actually displayed by renderer
*/
1567 short int win_top
; /* the rect area is expressed within the
*/
1568 short int win_right
; /* boundaries of the screen buffer
*/
1569 short int win_bottom
;
1570 short int max_width
; /* maximum
size (width x height
) for the window
*/
1571 short int max_height
;
1572 short int font_width
; /* font
size (width x height
) */
1573 short int font_height
;
1574 VARARG(colors
,uints
); /* color table
*/
1577 /* Add input records to a console input queue
*/
1578 @
REQ(write_console_input
)
1579 obj_handle_t handle
; /* handle to the console input
*/
1580 VARARG(rec
,input_records
); /* input records
*/
1582 int written
; /* number of records written
*/
1586 /* Fetch input records from a console input queue
*/
1587 @
REQ(read_console_input
)
1588 obj_handle_t handle
; /* handle to the console input
*/
1589 int flush
; /* flush the retrieved records from the queue?
*/
1591 int read
; /* number of records read
*/
1592 VARARG(rec
,input_records
); /* input records
*/
1596 /* write
data (chars and
/or attributes
) in a screen buffer
*/
1597 @
REQ(write_console_output
)
1598 obj_handle_t handle
; /* handle to the console output
*/
1599 int x
; /* position where to start writing
*/
1601 int mode
; /* char
info (see below
) */
1602 int wrap
; /* wrap around at end of line?
*/
1603 VARARG(data
,bytes
); /* info to write
*/
1605 int written
; /* number of char infos actually written
*/
1606 int width
; /* width of screen buffer
*/
1607 int height
; /* height of screen buffer
*/
1611 CHAR_INFO_MODE_TEXT
, /* characters only
*/
1612 CHAR_INFO_MODE_ATTR
, /* attributes only
*/
1613 CHAR_INFO_MODE_TEXTATTR
, /* both characters and attributes
*/
1614 CHAR_INFO_MODE_TEXTSTDATTR
/* characters but use standard attributes
*/
1618 /* fill a screen buffer with constant
data (chars and
/or attributes
) */
1619 @
REQ(fill_console_output
)
1620 obj_handle_t handle
; /* handle to the console output
*/
1621 int x
; /* position where to start writing
*/
1623 int mode
; /* char info mode
*/
1624 int count
; /* number to write
*/
1625 int wrap
; /* wrap around at end of line?
*/
1626 char_info_t data
; /* data to write
*/
1628 int written
; /* number of char infos actually written
*/
1632 /* read
data (chars and
/or attributes
) from a screen buffer
*/
1633 @
REQ(read_console_output
)
1634 obj_handle_t handle
; /* handle to the console output
*/
1635 int x
; /* position (x
,y
) where to start reading
*/
1637 int mode
; /* char info mode
*/
1638 int wrap
; /* wrap around at end of line?
*/
1640 int width
; /* width of screen buffer
*/
1641 int height
; /* height of screen buffer
*/
1646 /* move a
rect (of data
) in screen buffer content
*/
1647 @
REQ(move_console_output
)
1648 obj_handle_t handle
; /* handle to the console output
*/
1649 short int x_src
; /* position (x
, y
) of rect to start moving from
*/
1651 short int x_dst
; /* position (x
, y
) of rect to move to
*/
1653 short int w
; /* size of the
rect (width
, height
) to move
*/
1658 /* Sends a signal to a process group
*/
1659 @
REQ(send_console_signal
)
1660 int signal
; /* the signal to send
*/
1661 process_id_t group_id
; /* the group to send the signal to
*/
1665 /* enable directory change notifications
*/
1666 @
REQ(read_directory_changes
)
1667 unsigned int filter
; /* notification filter
*/
1668 int subtree
; /* watch the subtree?
*/
1669 int want_data
; /* flag indicating whether change data should be collected
*/
1670 async_data_t async
; /* async I
/O parameters
*/
1675 obj_handle_t handle
;
1677 VARARG(events
,filesystem_event
); /* collected filesystem events
*/
1681 /* Create a file mapping
*/
1682 @
REQ(create_mapping
)
1683 unsigned int access
; /* wanted access rights
*/
1684 unsigned int flags
; /* SEC_
* flags
*/
1685 unsigned int protect
; /* protection
flags (see below
) */
1686 mem_size_t size
; /* mapping size
*/
1687 obj_handle_t file_handle
; /* file handle
*/
1688 VARARG(objattr
,object_attributes
); /* object attributes
*/
1690 obj_handle_t handle
; /* handle to the mapping
*/
1692 /* per
-page protection flags
*/
1693 #define VPROT_READ
0x01
1694 #define VPROT_WRITE
0x02
1695 #define VPROT_EXEC
0x04
1696 #define VPROT_WRITECOPY
0x08
1697 #define VPROT_GUARD
0x10
1698 #define VPROT_NOCACHE
0x20
1699 #define VPROT_COMMITTED
0x40
1700 #define VPROT_WRITEWATCH
0x80
1701 /* per
-mapping protection flags
*/
1702 #define VPROT_IMAGE
0x0100 /* mapping for an exe image
*/
1703 #define VPROT_SYSTEM
0x0200 /* system
view (underlying mmap not under our control
) */
1704 #define VPROT_VALLOC
0x0400 /* allocated by VirtualAlloc
*/
1705 #define VPROT_NOEXEC
0x0800 /* don
't force exec permission */
1708 /* Open a mapping */
1710 unsigned int access; /* wanted access rights */
1711 unsigned int attributes; /* object attributes */
1712 obj_handle_t rootdir; /* root directory */
1713 VARARG(name,unicode_str); /* object name */
1715 obj_handle_t handle; /* handle to the mapping */
1719 /* Get information about a file mapping */
1720 @REQ(get_mapping_info)
1721 obj_handle_t handle; /* handle to the mapping */
1722 unsigned int access; /* wanted access rights */
1724 mem_size_t size; /* mapping size */
1725 unsigned int flags; /* SEC_* flags */
1726 int protect; /* protection flags */
1727 obj_handle_t mapping; /* duplicate mapping handle unless removable */
1728 obj_handle_t shared_file; /* shared mapping file handle */
1729 VARARG(image,pe_image_info);/* image info for SEC_IMAGE mappings */
1733 /* Get a range of committed pages in a file mapping */
1734 @REQ(get_mapping_committed_range)
1735 obj_handle_t handle; /* handle to the mapping */
1736 file_pos_t offset; /* starting offset (page-aligned, in bytes) */
1738 mem_size_t size; /* size of range starting at offset (page-aligned, in bytes) */
1739 int committed; /* whether it is a committed range */
1743 /* Add a range to the committed pages in a file mapping */
1744 @REQ(add_mapping_committed_range)
1745 obj_handle_t handle; /* handle to the mapping */
1746 file_pos_t offset; /* starting offset (page-aligned, in bytes) */
1747 mem_size_t size; /* size to set (page-aligned, in bytes) or 0 if only retrieving */
1751 #define SNAP_PROCESS 0x00000001
1752 #define SNAP_THREAD 0x00000002
1753 /* Create a snapshot */
1754 @REQ(create_snapshot)
1755 unsigned int attributes; /* object attributes */
1756 unsigned int flags; /* snapshot flags (SNAP_*) */
1758 obj_handle_t handle; /* handle to the snapshot */
1762 /* Get the next process from a snapshot */
1764 obj_handle_t handle; /* handle to the snapshot */
1765 int reset; /* reset snapshot position? */
1767 int count; /* process usage count */
1768 process_id_t pid; /* process id */
1769 process_id_t ppid; /* parent process id */
1770 int threads; /* number of threads */
1771 int priority; /* process priority */
1772 int handles; /* number of handles */
1773 int unix_pid; /* Unix pid */
1774 VARARG(filename,unicode_str); /* file name of main exe */
1778 /* Get the next thread from a snapshot */
1780 obj_handle_t handle; /* handle to the snapshot */
1781 int reset; /* reset snapshot position? */
1783 int count; /* thread usage count */
1784 process_id_t pid; /* process id */
1785 thread_id_t tid; /* thread id */
1786 int base_pri; /* base priority */
1787 int delta_pri; /* delta priority */
1791 /* Wait for a debug event */
1792 @REQ(wait_debug_event)
1793 int get_handle; /* should we alloc a handle for waiting? */
1795 process_id_t pid; /* process id */
1796 thread_id_t tid; /* thread id */
1797 obj_handle_t wait; /* wait handle if no event ready */
1798 VARARG(event,debug_event); /* debug event data */
1802 /* Queue an exception event */
1803 @REQ(queue_exception_event)
1804 int first; /* first chance exception? */
1805 unsigned int code; /* exception code */
1806 unsigned int flags; /* exception flags */
1807 client_ptr_t record; /* exception record */
1808 client_ptr_t address; /* exception address */
1809 data_size_t len; /* size of parameters */
1810 VARARG(params,uints64,len);/* exception parameters */
1811 VARARG(context,context); /* thread context */
1813 obj_handle_t handle; /* handle to the queued event */
1817 /* Retrieve the status of an exception event */
1818 @REQ(get_exception_status)
1819 obj_handle_t handle; /* handle to the queued event */
1821 VARARG(context,context); /* modified thread context */
1825 /* Continue a debug event */
1826 @REQ(continue_debug_event)
1827 process_id_t pid; /* process id to continue */
1828 thread_id_t tid; /* thread id to continue */
1829 int status; /* continuation status */
1833 /* Start/stop debugging an existing process */
1835 process_id_t pid; /* id of the process to debug */
1836 int attach; /* 1=attaching / 0=detaching from the process */
1840 /* Simulate a breakpoint in a process */
1842 obj_handle_t handle; /* process handle */
1844 int self; /* was it the caller itself? */
1848 /* Set debugger kill on exit flag */
1849 @REQ(set_debugger_kill_on_exit)
1850 int kill_on_exit; /* 0=detach/1=kill debuggee when debugger dies */
1854 /* Read data from a process address space */
1855 @REQ(read_process_memory)
1856 obj_handle_t handle; /* process handle */
1857 client_ptr_t addr; /* addr to read from */
1859 VARARG(data,bytes); /* result data */
1863 /* Write data to a process address space */
1864 @REQ(write_process_memory)
1865 obj_handle_t handle; /* process handle */
1866 client_ptr_t addr; /* addr to write to */
1867 VARARG(data,bytes); /* data to write */
1871 /* Create a registry key */
1873 unsigned int access; /* desired access rights */
1874 unsigned int options; /* creation options */
1875 VARARG(objattr,object_attributes); /* object attributes */
1876 VARARG(class,unicode_str); /* class name */
1878 obj_handle_t hkey; /* handle to the created key */
1879 int created; /* has it been newly created? */
1882 /* Open a registry key */
1884 obj_handle_t parent; /* handle to the parent key */
1885 unsigned int access; /* desired access rights */
1886 unsigned int attributes; /* object attributes */
1887 VARARG(name,unicode_str); /* key name */
1889 obj_handle_t hkey; /* handle to the open key */
1893 /* Delete a registry key */
1895 obj_handle_t hkey; /* handle to the key */
1899 /* Flush a registry key */
1901 obj_handle_t hkey; /* handle to the key */
1905 /* Enumerate registry subkeys */
1907 obj_handle_t hkey; /* handle to registry key */
1908 int index; /* index of subkey (or -1 for current key) */
1909 int info_class; /* requested information class */
1911 int subkeys; /* number of subkeys */
1912 int max_subkey; /* longest subkey name */
1913 int max_class; /* longest class name */
1914 int values; /* number of values */
1915 int max_value; /* longest value name */
1916 int max_data; /* longest value data */
1917 timeout_t modif; /* last modification time */
1918 data_size_t total; /* total length needed for full name and class */
1919 data_size_t namelen; /* length of key name in bytes */
1920 VARARG(name,unicode_str,namelen); /* key name */
1921 VARARG(class,unicode_str); /* class name */
1925 /* Set a value of a registry key */
1927 obj_handle_t hkey; /* handle to registry key */
1928 int type; /* value type */
1929 data_size_t namelen; /* length of value name in bytes */
1930 VARARG(name,unicode_str,namelen); /* value name */
1931 VARARG(data,bytes); /* value data */
1935 /* Retrieve the value of a registry key */
1937 obj_handle_t hkey; /* handle to registry key */
1938 VARARG(name,unicode_str); /* value name */
1940 int type; /* value type */
1941 data_size_t total; /* total length needed for data */
1942 VARARG(data,bytes); /* value data */
1946 /* Enumerate a value of a registry key */
1947 @REQ(enum_key_value)
1948 obj_handle_t hkey; /* handle to registry key */
1949 int index; /* value index */
1950 int info_class; /* requested information class */
1952 int type; /* value type */
1953 data_size_t total; /* total length needed for full name and data */
1954 data_size_t namelen; /* length of value name in bytes */
1955 VARARG(name,unicode_str,namelen); /* value name */
1956 VARARG(data,bytes); /* value data */
1960 /* Delete a value of a registry key */
1961 @REQ(delete_key_value)
1962 obj_handle_t hkey; /* handle to registry key */
1963 VARARG(name,unicode_str); /* value name */
1967 /* Load a registry branch from a file */
1969 obj_handle_t file; /* file to load from */
1970 VARARG(objattr,object_attributes); /* object attributes */
1974 /* UnLoad a registry branch from a file */
1975 @REQ(unload_registry)
1976 obj_handle_t hkey; /* root key to unload to */
1980 /* Save a registry branch to a file */
1982 obj_handle_t hkey; /* key to save */
1983 obj_handle_t file; /* file to save to */
1987 /* Add a registry key change notification */
1988 @REQ(set_registry_notification)
1989 obj_handle_t hkey; /* key to watch for changes */
1990 obj_handle_t event; /* event to set */
1991 int subtree; /* should we watch the whole subtree? */
1992 unsigned int filter; /* things to watch */
1996 /* Create a waitable timer */
1998 unsigned int access; /* wanted access rights */
1999 int manual; /* manual reset */
2000 VARARG(objattr,object_attributes); /* object attributes */
2002 obj_handle_t handle; /* handle to the timer */
2006 /* Open a waitable timer */
2008 unsigned int access; /* wanted access rights */
2009 unsigned int attributes; /* object attributes */
2010 obj_handle_t rootdir; /* root directory */
2011 VARARG(name,unicode_str); /* object name */
2013 obj_handle_t handle; /* handle to the timer */
2016 /* Set a waitable timer */
2018 obj_handle_t handle; /* handle to the timer */
2019 timeout_t expire; /* next expiration absolute time */
2020 client_ptr_t callback; /* callback function */
2021 client_ptr_t arg; /* callback argument */
2022 int period; /* timer period in ms */
2024 int signaled; /* was the timer signaled before this call ? */
2027 /* Cancel a waitable timer */
2029 obj_handle_t handle; /* handle to the timer */
2031 int signaled; /* was the timer signaled before this calltime ? */
2034 /* Get information on a waitable timer */
2035 @REQ(get_timer_info)
2036 obj_handle_t handle; /* handle to the timer */
2038 timeout_t when; /* absolute time when the timer next expires */
2039 int signaled; /* is the timer signaled? */
2043 /* Retrieve the current context of a thread */
2044 @REQ(get_thread_context)
2045 obj_handle_t handle; /* thread handle */
2046 unsigned int flags; /* context flags */
2047 int suspend; /* suspend the thread if needed */
2049 int self; /* was it a handle to the current thread? */
2050 VARARG(context,context); /* thread context */
2054 /* Set the current context of a thread */
2055 @REQ(set_thread_context)
2056 obj_handle_t handle; /* thread handle */
2057 int suspend; /* suspend the thread if needed */
2058 VARARG(context,context); /* thread context */
2060 int self; /* was it a handle to the current thread? */
2064 /* Fetch a selector entry for a thread */
2065 @REQ(get_selector_entry)
2066 obj_handle_t handle; /* thread handle */
2067 int entry; /* LDT entry */
2069 unsigned int base; /* selector base */
2070 unsigned int limit; /* selector limit */
2071 unsigned char flags; /* selector flags */
2077 obj_handle_t table; /* which table to add atom to */
2078 VARARG(name,unicode_str); /* atom name */
2080 atom_t atom; /* resulting atom */
2084 /* Delete an atom */
2086 obj_handle_t table; /* which table to delete atom from */
2087 atom_t atom; /* atom handle */
2093 obj_handle_t table; /* which table to find atom from */
2094 VARARG(name,unicode_str); /* atom name */
2096 atom_t atom; /* atom handle */
2100 /* Get information about an atom */
2101 @REQ(get_atom_information)
2102 obj_handle_t table; /* which table to find atom from */
2103 atom_t atom; /* atom handle */
2105 int count; /* atom lock count */
2106 int pinned; /* whether the atom has been pinned */
2107 data_size_t total; /* actual length of atom name */
2108 VARARG(name,unicode_str); /* atom name */
2112 /* Set information about an atom */
2113 @REQ(set_atom_information)
2114 obj_handle_t table; /* which table to find atom from */
2115 atom_t atom; /* atom handle */
2116 int pinned; /* whether to bump atom information */
2120 /* Empty an atom table */
2121 @REQ(empty_atom_table)
2122 obj_handle_t table; /* which table to find atom from */
2123 int if_pinned; /* whether to delete pinned atoms */
2127 /* Init an atom table */
2128 @REQ(init_atom_table)
2129 int entries; /* number of entries (only for local) */
2131 obj_handle_t table; /* handle to the atom table */
2135 /* Get the message queue of the current thread */
2138 obj_handle_t handle; /* handle to the queue */
2142 /* Set the file descriptor associated to the current thread queue */
2144 obj_handle_t handle; /* handle to the file descriptor */
2148 /* Set the current message queue wakeup mask */
2149 @REQ(set_queue_mask)
2150 unsigned int wake_mask; /* wakeup bits mask */
2151 unsigned int changed_mask; /* changed bits mask */
2152 int skip_wait; /* will we skip waiting if signaled? */
2154 unsigned int wake_bits; /* current wake bits */
2155 unsigned int changed_bits; /* current changed bits */
2159 /* Get the current message queue status */
2160 @REQ(get_queue_status)
2161 unsigned int clear_bits; /* should we clear the change bits? */
2163 unsigned int wake_bits; /* wake bits */
2164 unsigned int changed_bits; /* changed bits since last time */
2168 /* Retrieve the process idle event */
2169 @REQ(get_process_idle_event)
2170 obj_handle_t handle; /* process handle */
2172 obj_handle_t event; /* handle to idle event */
2176 /* Send a message to a thread queue */
2178 thread_id_t id; /* thread id */
2179 int type; /* message type (see below) */
2180 int flags; /* message flags (see below) */
2181 user_handle_t win; /* window handle */
2182 unsigned int msg; /* message code */
2183 lparam_t wparam; /* parameters */
2184 lparam_t lparam; /* parameters */
2185 timeout_t timeout; /* timeout for reply */
2186 VARARG(data,message_data); /* message data for sent messages */
2189 @REQ(post_quit_message)
2190 int exit_code; /* exit code to return */
2195 MSG_ASCII, /* Ascii message (from SendMessageA) */
2196 MSG_UNICODE, /* Unicode message (from SendMessageW) */
2197 MSG_NOTIFY, /* notify message (from SendNotifyMessageW), always Unicode */
2198 MSG_CALLBACK, /* callback message (from SendMessageCallbackW), always Unicode */
2199 MSG_CALLBACK_RESULT,/* result of a callback message */
2200 MSG_OTHER_PROCESS, /* sent from other process, may include vararg data, always Unicode */
2201 MSG_POSTED, /* posted message (from PostMessageW), always Unicode */
2202 MSG_HARDWARE, /* hardware message */
2203 MSG_WINEVENT, /* winevent message */
2204 MSG_HOOK_LL /* low-level hardware hook */
2206 #define SEND_MSG_ABORT_IF_HUNG 0x01
2209 /* Send a hardware message to a thread queue */
2210 @REQ(send_hardware_message)
2211 user_handle_t win; /* window handle */
2212 hw_input_t input; /* input data */
2213 unsigned int flags; /* flags (see below) */
2215 int wait; /* do we need to wait for a reply? */
2216 int prev_x; /* previous cursor position */
2218 int new_x; /* new cursor position */
2220 VARARG(keystate,bytes); /* global state array for all the keys */
2222 #define SEND_HWMSG_INJECTED 0x01
2225 /* Get a message from the current queue */
2227 unsigned int flags; /* PM_* flags */
2228 user_handle_t get_win; /* window handle to get */
2229 unsigned int get_first; /* first message code to get */
2230 unsigned int get_last; /* last message code to get */
2231 unsigned int hw_id; /* id of the previous hardware message (or 0) */
2232 unsigned int wake_mask; /* wakeup bits mask */
2233 unsigned int changed_mask; /* changed bits mask */
2235 user_handle_t win; /* window handle */
2236 unsigned int msg; /* message code */
2237 lparam_t wparam; /* parameters */
2238 lparam_t lparam; /* parameters */
2239 int type; /* message type */
2240 int x; /* message x position */
2241 int y; /* message y position */
2242 unsigned int time; /* message time */
2243 unsigned int active_hooks; /* active hooks bitmap */
2244 data_size_t total; /* total size of extra data */
2245 VARARG(data,message_data); /* message data for sent messages */
2249 /* Reply to a sent message */
2251 int remove; /* should we remove the message? */
2252 lparam_t result; /* message result */
2253 VARARG(data,bytes); /* message data for sent messages */
2257 /* Accept the current hardware message */
2258 @REQ(accept_hardware_message)
2259 unsigned int hw_id; /* id of the hardware message */
2260 int remove; /* should we remove the message? */
2264 /* Retrieve the reply for the last message sent */
2265 @REQ(get_message_reply)
2266 int cancel; /* cancel message if not ready? */
2268 lparam_t result; /* message result */
2269 VARARG(data,bytes); /* message data for sent messages */
2273 /* Set a window timer */
2275 user_handle_t win; /* window handle */
2276 unsigned int msg; /* message to post */
2277 unsigned int rate; /* timer rate in ms */
2278 lparam_t id; /* timer id */
2279 lparam_t lparam; /* message lparam (callback proc) */
2281 lparam_t id; /* timer id */
2285 /* Kill a window timer */
2286 @REQ(kill_win_timer)
2287 user_handle_t win; /* window handle */
2288 lparam_t id; /* timer id */
2289 unsigned int msg; /* message to post */
2293 /* check if the thread owning the window is hung */
2294 @REQ(is_window_hung)
2295 user_handle_t win; /* window handle */
2301 /* Retrieve info about a serial port */
2302 @REQ(get_serial_info)
2303 obj_handle_t handle; /* handle to comm port */
2306 unsigned int readinterval;
2307 unsigned int readconst;
2308 unsigned int readmult;
2309 unsigned int writeconst;
2310 unsigned int writemult;
2311 unsigned int eventmask;
2312 unsigned int cookie;
2313 unsigned int pending_write;
2317 /* Set info about a serial port */
2318 @REQ(set_serial_info)
2319 obj_handle_t handle; /* handle to comm port */
2320 int flags; /* bitmask to set values (see below) */
2321 unsigned int readinterval;
2322 unsigned int readconst;
2323 unsigned int readmult;
2324 unsigned int writeconst;
2325 unsigned int writemult;
2326 unsigned int eventmask;
2328 #define SERIALINFO_SET_TIMEOUTS 0x01
2329 #define SERIALINFO_SET_MASK 0x02
2330 #define SERIALINFO_PENDING_WRITE 0x04
2331 #define SERIALINFO_PENDING_WAIT 0x08
2334 /* Create an async I/O */
2335 @REQ(register_async)
2336 int type; /* type of queue to look after */
2337 async_data_t async; /* async I/O parameters */
2338 int count; /* count - usually # of bytes to be read/written */
2340 #define ASYNC_TYPE_READ 0x01
2341 #define ASYNC_TYPE_WRITE 0x02
2342 #define ASYNC_TYPE_WAIT 0x03
2345 /* Cancel all async op on a fd */
2347 obj_handle_t handle; /* handle to comm port, socket or file */
2348 client_ptr_t iosb; /* I/O status block (NULL=all) */
2349 int only_thread; /* cancel matching this thread */
2353 /* Retrieve results of an async */
2354 @REQ(get_async_result)
2355 client_ptr_t user_arg; /* user arg used to identify async */
2357 data_size_t size; /* result size (input or output depending on the operation) */
2358 VARARG(out_data,bytes); /* iosb output data */
2362 /* Perform a read on a file object */
2364 int blocking; /* whether it's a blocking read
*/
2365 async_data_t async
; /* async I
/O parameters
*/
2366 file_pos_t pos
; /* read position
*/
2368 obj_handle_t wait
; /* handle to wait on for blocking read
*/
2369 unsigned int options
; /* device open options
*/
2370 VARARG(data
,bytes
); /* read data
*/
2374 /* Perform a write on a file object
*/
2376 int blocking
; /* whether it
's a blocking write */
2377 async_data_t async; /* async I/O parameters */
2378 file_pos_t pos; /* write position */
2379 VARARG(data,bytes); /* write data */
2381 obj_handle_t wait; /* handle to wait on for blocking write */
2382 unsigned int options; /* device open options */
2383 data_size_t size; /* size written */
2387 /* Perform an ioctl on a file */
2389 ioctl_code_t code; /* ioctl code */
2390 async_data_t async; /* async I/O parameters */
2391 int blocking; /* whether it's a blocking ioctl
*/
2392 VARARG(in_data
,bytes
); /* ioctl input data
*/
2394 obj_handle_t wait
; /* handle to wait on for blocking ioctl
*/
2395 unsigned int options
; /* device open options
*/
2396 VARARG(out_data
,bytes
); /* ioctl output data
*/
2400 /* Store results of an async irp
*/
2401 @
REQ(set_irp_result
)
2402 obj_handle_t handle
; /* handle to the irp
*/
2403 unsigned int status
; /* status of the irp
*/
2404 data_size_t size
; /* result
size (input or output depending on the operation
) */
2405 client_ptr_t file_ptr
; /* opaque pointer to the file object
*/
2406 VARARG(data
,bytes
); /* output data of the irp
*/
2410 /* Create a named pipe
*/
2411 @
REQ(create_named_pipe
)
2412 unsigned int access
;
2413 unsigned int options
;
2414 unsigned int sharing
;
2415 unsigned int maxinstances
;
2416 unsigned int outsize
;
2417 unsigned int insize
;
2420 VARARG(objattr
,object_attributes
); /* object attributes
*/
2422 obj_handle_t handle
; /* handle to the pipe
*/
2425 /* flags in create_named_pipe and get_named_pipe_info
*/
2426 #define NAMED_PIPE_MESSAGE_STREAM_WRITE
0x0001
2427 #define NAMED_PIPE_MESSAGE_STREAM_READ
0x0002
2428 #define NAMED_PIPE_NONBLOCKING_MODE
0x0004
2429 #define NAMED_PIPE_SERVER_END
0x8000
2431 /* Get named pipe information by handle
*/
2432 @
REQ(get_named_pipe_info
)
2433 obj_handle_t handle
;
2436 unsigned int sharing
;
2437 unsigned int maxinstances
;
2438 unsigned int instances
;
2439 unsigned int outsize
;
2440 unsigned int insize
;
2443 /* Set named pipe information by handle
*/
2444 @
REQ(set_named_pipe_info
)
2445 obj_handle_t handle
;
2449 /* Create a window
*/
2451 user_handle_t parent
; /* parent window
*/
2452 user_handle_t owner
; /* owner window
*/
2453 atom_t atom
; /* class atom
*/
2454 mod_handle_t instance
; /* module instance
*/
2455 VARARG(class
,unicode_str
); /* class name
*/
2457 user_handle_t handle
; /* created window
*/
2458 user_handle_t parent
; /* full handle of parent
*/
2459 user_handle_t owner
; /* full handle of owner
*/
2460 int extra
; /* number of extra bytes
*/
2461 client_ptr_t class_ptr
; /* pointer to class in client address space
*/
2465 /* Destroy a window
*/
2466 @
REQ(destroy_window
)
2467 user_handle_t handle
; /* handle to the window
*/
2471 /* Retrieve the desktop window for the current thread
*/
2472 @
REQ(get_desktop_window
)
2473 int force
; /* force creation if it doesn
't exist */
2475 user_handle_t top_window; /* handle to the desktop window */
2476 user_handle_t msg_window; /* handle to the top-level HWND_MESSAGE parent */
2480 /* Set a window owner */
2481 @REQ(set_window_owner)
2482 user_handle_t handle; /* handle to the window */
2483 user_handle_t owner; /* new owner */
2485 user_handle_t full_owner; /* full handle of new owner */
2486 user_handle_t prev_owner; /* full handle of previous owner */
2490 /* Get information from a window handle */
2491 @REQ(get_window_info)
2492 user_handle_t handle; /* handle to the window */
2494 user_handle_t full_handle; /* full 32-bit handle */
2495 user_handle_t last_active; /* last active popup */
2496 process_id_t pid; /* process owning the window */
2497 thread_id_t tid; /* thread owning the window */
2498 atom_t atom; /* class atom */
2499 int is_unicode; /* ANSI or unicode */
2503 /* Set some information in a window */
2504 @REQ(set_window_info)
2505 unsigned short flags; /* flags for fields to set (see below) */
2506 short int is_unicode; /* ANSI or unicode */
2507 user_handle_t handle; /* handle to the window */
2508 unsigned int style; /* window style */
2509 unsigned int ex_style; /* window extended style */
2510 unsigned int id; /* window id */
2511 mod_handle_t instance; /* creator instance */
2512 lparam_t user_data; /* user-specific data */
2513 int extra_offset; /* offset to set in extra bytes */
2514 data_size_t extra_size; /* size to set in extra bytes */
2515 lparam_t extra_value; /* value to set in extra bytes */
2517 unsigned int old_style; /* old window style */
2518 unsigned int old_ex_style; /* old window extended style */
2519 mod_handle_t old_instance; /* old creator instance */
2520 lparam_t old_user_data; /* old user-specific data */
2521 lparam_t old_extra_value; /* old value in extra bytes */
2522 unsigned int old_id; /* old window id */
2524 #define SET_WIN_STYLE 0x01
2525 #define SET_WIN_EXSTYLE 0x02
2526 #define SET_WIN_ID 0x04
2527 #define SET_WIN_INSTANCE 0x08
2528 #define SET_WIN_USERDATA 0x10
2529 #define SET_WIN_EXTRA 0x20
2530 #define SET_WIN_UNICODE 0x40
2533 /* Set the parent of a window */
2535 user_handle_t handle; /* handle to the window */
2536 user_handle_t parent; /* handle to the parent */
2538 user_handle_t old_parent; /* old parent window */
2539 user_handle_t full_parent; /* full handle of new parent */
2543 /* Get a list of the window parents, up to the root of the tree */
2544 @REQ(get_window_parents)
2545 user_handle_t handle; /* handle to the window */
2547 int count; /* total count of parents */
2548 VARARG(parents,user_handles); /* parent handles */
2552 /* Get a list of the window children */
2553 @REQ(get_window_children)
2554 obj_handle_t desktop; /* handle to desktop */
2555 user_handle_t parent; /* parent window */
2556 atom_t atom; /* class atom for the listed children */
2557 thread_id_t tid; /* thread owning the listed children */
2558 VARARG(class,unicode_str); /* class name */
2560 int count; /* total count of children */
2561 VARARG(children,user_handles); /* children handles */
2565 /* Get a list of the window children that contain a given point */
2566 @REQ(get_window_children_from_point)
2567 user_handle_t parent; /* parent window */
2568 int x; /* point in parent coordinates */
2571 int count; /* total count of children */
2572 VARARG(children,user_handles); /* children handles */
2576 /* Get window tree information from a window handle */
2577 @REQ(get_window_tree)
2578 user_handle_t handle; /* handle to the window */
2580 user_handle_t parent; /* parent window */
2581 user_handle_t owner; /* owner window */
2582 user_handle_t next_sibling; /* next sibling in Z-order */
2583 user_handle_t prev_sibling; /* prev sibling in Z-order */
2584 user_handle_t first_sibling; /* first sibling in Z-order */
2585 user_handle_t last_sibling; /* last sibling in Z-order */
2586 user_handle_t first_child; /* first child */
2587 user_handle_t last_child; /* last child */
2590 /* Set the position and Z order of a window */
2591 @REQ(set_window_pos)
2592 unsigned short swp_flags; /* SWP_* flags */
2593 unsigned short paint_flags; /* paint flags (see below) */
2594 user_handle_t handle; /* handle to the window */
2595 user_handle_t previous; /* previous window in Z order */
2596 rectangle_t window; /* window rectangle (in parent coords) */
2597 rectangle_t client; /* client rectangle (in parent coords) */
2598 VARARG(valid,rectangles); /* valid rectangles from WM_NCCALCSIZE (in parent coords) */
2600 unsigned int new_style; /* new window style */
2601 unsigned int new_ex_style; /* new window extended style */
2602 user_handle_t surface_win; /* window that needs a surface update */
2604 #define SET_WINPOS_PAINT_SURFACE 0x01 /* window has a paintable surface */
2605 #define SET_WINPOS_PIXEL_FORMAT 0x02 /* window has a custom pixel format */
2607 /* Get the window and client rectangles of a window */
2608 @REQ(get_window_rectangles)
2609 user_handle_t handle; /* handle to the window */
2610 int relative; /* coords relative to (see below) */
2612 rectangle_t window; /* window rectangle */
2613 rectangle_t visible; /* visible part of the window rectangle */
2614 rectangle_t client; /* client rectangle */
2616 enum coords_relative
2618 COORDS_CLIENT, /* relative to client area */
2619 COORDS_WINDOW, /* relative to whole window area */
2620 COORDS_PARENT, /* relative to parent's client area
*/
2621 COORDS_SCREEN
/* relative to screen origin
*/
2625 /* Get the window text
*/
2626 @
REQ(get_window_text
)
2627 user_handle_t handle
; /* handle to the window
*/
2629 VARARG(text
,unicode_str
); /* window text
*/
2633 /* Set the window text
*/
2634 @
REQ(set_window_text
)
2635 user_handle_t handle
; /* handle to the window
*/
2636 VARARG(text
,unicode_str
); /* window text
*/
2640 /* Get the coordinates offset between two windows
*/
2641 @
REQ(get_windows_offset
)
2642 user_handle_t from
; /* handle to the first window
*/
2643 user_handle_t to
; /* handle to the second window
*/
2645 int x
; /* x coordinate offset
*/
2646 int y
; /* y coordinate offset
*/
2647 int mirror
; /* whether to mirror the x coordinate
*/
2651 /* Get the visible region of a window
*/
2652 @
REQ(get_visible_region
)
2653 user_handle_t window
; /* handle to the window
*/
2654 unsigned int flags
; /* DCX flags
*/
2656 user_handle_t top_win
; /* top window to clip against
*/
2657 rectangle_t top_rect
; /* top window visible rect with screen coords
*/
2658 rectangle_t win_rect
; /* window rect in screen coords
*/
2659 unsigned int paint_flags
; /* paint
flags (from SET_WINPOS_
* flags
) */
2660 data_size_t total_size
; /* total size of the resulting region
*/
2661 VARARG(region
,rectangles
); /* list of rectangles for the
region (in screen coords
) */
2665 /* Get the visible surface region of a window
*/
2666 @
REQ(get_surface_region
)
2667 user_handle_t window
; /* handle to the window
*/
2669 rectangle_t visible_rect
; /* window visible rect in screen coords
*/
2670 data_size_t total_size
; /* total size of the resulting region
*/
2671 VARARG(region
,rectangles
); /* list of rectangles for the
region (in screen coords
) */
2675 /* Get the window region
*/
2676 @
REQ(get_window_region
)
2677 user_handle_t window
; /* handle to the window
*/
2679 data_size_t total_size
; /* total size of the resulting region
*/
2680 VARARG(region
,rectangles
); /* list of rectangles for the
region (in window coords
) */
2684 /* Set the window region
*/
2685 @
REQ(set_window_region
)
2686 user_handle_t window
; /* handle to the window
*/
2687 int redraw
; /* redraw the window?
*/
2688 VARARG(region
,rectangles
); /* list of rectangles for the
region (in window coords
) */
2692 /* Get the window update region
*/
2693 @
REQ(get_update_region
)
2694 user_handle_t window
; /* handle to the window
*/
2695 user_handle_t from_child
; /* child to start searching from
*/
2696 unsigned int flags
; /* update
flags (see below
) */
2698 user_handle_t child
; /* child to
repaint (or window itself
) */
2699 unsigned int flags
; /* resulting update
flags (see below
) */
2700 data_size_t total_size
; /* total size of the resulting region
*/
2701 VARARG(region
,rectangles
); /* list of rectangles for the
region (in screen coords
) */
2703 #define UPDATE_NONCLIENT
0x01 /* get region for repainting non
-client area
*/
2704 #define UPDATE_ERASE
0x02 /* get region for erasing client area
*/
2705 #define UPDATE_PAINT
0x04 /* get region for painting client area
*/
2706 #define UPDATE_INTERNALPAINT
0x08 /* get region if internal paint is pending
*/
2707 #define UPDATE_ALLCHILDREN
0x10 /* force repaint of all children
*/
2708 #define UPDATE_NOCHILDREN
0x20 /* don
't try to repaint any children */
2709 #define UPDATE_NOREGION 0x40 /* don't return a region
, only the flags
*/
2710 #define UPDATE_DELAYED_ERASE
0x80 /* still needs erase after BeginPaint
*/
2713 /* Update the z order of a window so that a given rectangle is fully visible
*/
2714 @
REQ(update_window_zorder
)
2715 user_handle_t window
; /* handle to the window
*/
2716 rectangle_t rect
; /* rectangle that must be
visible (in client coords
) */
2720 /* Mark parts of a window as needing a redraw
*/
2722 user_handle_t window
; /* handle to the window
*/
2723 unsigned int flags
; /* RDW_
* flags
*/
2724 VARARG(region
,rectangles
); /* list of rectangles for the
region (in window coords
) */
2728 /* Set a window property
*/
2729 @
REQ(set_window_property
)
2730 user_handle_t window
; /* handle to the window
*/
2731 lparam_t data
; /* data to store
*/
2732 atom_t atom
; /* property
atom (if no name specified
) */
2733 VARARG(name
,unicode_str
); /* property name
*/
2737 /* Remove a window property
*/
2738 @
REQ(remove_window_property
)
2739 user_handle_t window
; /* handle to the window
*/
2740 atom_t atom
; /* property
atom (if no name specified
) */
2741 VARARG(name
,unicode_str
); /* property name
*/
2743 lparam_t data
; /* data stored in property
*/
2747 /* Get a window property
*/
2748 @
REQ(get_window_property
)
2749 user_handle_t window
; /* handle to the window
*/
2750 atom_t atom
; /* property
atom (if no name specified
) */
2751 VARARG(name
,unicode_str
); /* property name
*/
2753 lparam_t data
; /* data stored in property
*/
2757 /* Get the list of properties of a window
*/
2758 @
REQ(get_window_properties
)
2759 user_handle_t window
; /* handle to the window
*/
2761 int total
; /* total number of properties
*/
2762 VARARG(props
,properties
); /* list of properties
*/
2766 /* Create a window station
*/
2767 @
REQ(create_winstation
)
2768 unsigned int flags
; /* window station flags
*/
2769 unsigned int access
; /* wanted access rights
*/
2770 unsigned int attributes
; /* object attributes
*/
2771 obj_handle_t rootdir
; /* root directory
*/
2772 VARARG(name
,unicode_str
); /* object name
*/
2774 obj_handle_t handle
; /* handle to the window station
*/
2778 /* Open a handle to a window station
*/
2779 @
REQ(open_winstation
)
2780 unsigned int access
; /* wanted access rights
*/
2781 unsigned int attributes
; /* object attributes
*/
2782 obj_handle_t rootdir
; /* root directory
*/
2783 VARARG(name
,unicode_str
); /* object name
*/
2785 obj_handle_t handle
; /* handle to the window station
*/
2789 /* Close a window station
*/
2790 @
REQ(close_winstation
)
2791 obj_handle_t handle
; /* handle to the window station
*/
2795 /* Get the process current window station
*/
2796 @
REQ(get_process_winstation
)
2798 obj_handle_t handle
; /* handle to the window station
*/
2802 /* Set the process current window station
*/
2803 @
REQ(set_process_winstation
)
2804 obj_handle_t handle
; /* handle to the window station
*/
2808 /* Enumerate window stations
*/
2809 @
REQ(enum_winstation
)
2810 unsigned int index
; /* current index
*/
2812 unsigned int next
; /* next index
*/
2813 VARARG(name
,unicode_str
); /* window station name
*/
2817 /* Create a desktop
*/
2818 @
REQ(create_desktop
)
2819 unsigned int flags
; /* desktop flags
*/
2820 unsigned int access
; /* wanted access rights
*/
2821 unsigned int attributes
; /* object attributes
*/
2822 VARARG(name
,unicode_str
); /* object name
*/
2824 obj_handle_t handle
; /* handle to the desktop
*/
2828 /* Open a handle to a desktop
*/
2830 obj_handle_t winsta
; /* window station to
open (null allowed
) */
2831 unsigned int flags
; /* desktop flags
*/
2832 unsigned int access
; /* wanted access rights
*/
2833 unsigned int attributes
; /* object attributes
*/
2834 VARARG(name
,unicode_str
); /* object name
*/
2836 obj_handle_t handle
; /* handle to the desktop
*/
2840 /* Open a handle to current input desktop
*/
2841 @
REQ(open_input_desktop
)
2842 unsigned int flags
; /* desktop flags
*/
2843 unsigned int access
; /* wanted access rights
*/
2844 unsigned int attributes
; /* object attributes
*/
2846 obj_handle_t handle
; /* handle to the desktop
*/
2850 /* Close a desktop
*/
2852 obj_handle_t handle
; /* handle to the desktop
*/
2856 /* Get the thread current desktop
*/
2857 @
REQ(get_thread_desktop
)
2858 thread_id_t tid
; /* thread id
*/
2860 obj_handle_t handle
; /* handle to the desktop
*/
2864 /* Set the thread current desktop
*/
2865 @
REQ(set_thread_desktop
)
2866 obj_handle_t handle
; /* handle to the desktop
*/
2870 /* Enumerate desktops
*/
2872 obj_handle_t winstation
; /* handle to the window station
*/
2873 unsigned int index
; /* current index
*/
2875 unsigned int next
; /* next index
*/
2876 VARARG(name
,unicode_str
); /* window station name
*/
2880 /* Get
/set information about a user
object (window station or desktop
) */
2881 @
REQ(set_user_object_info
)
2882 obj_handle_t handle
; /* handle to the object
*/
2883 unsigned int flags
; /* information to set
/get
*/
2884 unsigned int obj_flags
; /* new object flags
*/
2886 int is_desktop
; /* is object a desktop?
*/
2887 unsigned int old_obj_flags
; /* old object flags
*/
2888 VARARG(name
,unicode_str
); /* object name
*/
2890 #define SET_USER_OBJECT_SET_FLAGS
1
2891 #define SET_USER_OBJECT_GET_FULL_NAME
2
2894 /* Register a hotkey
*/
2895 @
REQ(register_hotkey
)
2896 user_handle_t window
; /* handle to the window
*/
2897 int id
; /* hotkey identifier
*/
2898 unsigned int flags
; /* modifier keys
*/
2899 unsigned int vkey
; /* virtual key code
*/
2901 int replaced
; /* did we replace an existing hotkey?
*/
2902 unsigned int flags
; /* flags of replaced hotkey
*/
2903 unsigned int vkey
; /* virtual key code of replaced hotkey
*/
2907 /* Unregister a hotkey
*/
2908 @
REQ(unregister_hotkey
)
2909 user_handle_t window
; /* handle to the window
*/
2910 int id
; /* hotkey identifier
*/
2912 unsigned int flags
; /* flags of removed hotkey
*/
2913 unsigned int vkey
; /* virtual key code of removed hotkey
*/
2917 /* Attach (or detach
) thread inputs
*/
2918 @
REQ(attach_thread_input
)
2919 thread_id_t tid_from
; /* thread to be attached
*/
2920 thread_id_t tid_to
; /* thread to which tid_from should be attached
*/
2921 int attach
; /* is it an attach?
*/
2925 /* Get input data for a given thread
*/
2926 @
REQ(get_thread_input
)
2927 thread_id_t tid
; /* id of thread
*/
2929 user_handle_t focus
; /* handle to the focus window
*/
2930 user_handle_t capture
; /* handle to the capture window
*/
2931 user_handle_t active
; /* handle to the active window
*/
2932 user_handle_t foreground
; /* handle to the global foreground window
*/
2933 user_handle_t menu_owner
; /* handle to the menu owner
*/
2934 user_handle_t move_size
; /* handle to the moving
/resizing window
*/
2935 user_handle_t caret
; /* handle to the caret window
*/
2936 user_handle_t cursor
; /* handle to the cursor
*/
2937 int show_count
; /* cursor show count
*/
2938 rectangle_t rect
; /* caret rectangle
*/
2942 /* Get the time of the last input event
*/
2943 @
REQ(get_last_input_time
)
2949 /* Retrieve queue keyboard state for a given thread
*/
2951 thread_id_t tid
; /* id of thread
*/
2952 int key
; /* optional key code or
-1 */
2954 unsigned char state
; /* state of specified key
*/
2955 VARARG(keystate
,bytes
); /* state array for all the keys
*/
2958 /* Set queue keyboard state for a given thread
*/
2960 thread_id_t tid
; /* id of thread
*/
2961 int async
; /* whether to change the async state too
*/
2962 VARARG(keystate
,bytes
); /* state array for all the keys
*/
2965 /* Set the system foreground window
*/
2966 @
REQ(set_foreground_window
)
2967 user_handle_t handle
; /* handle to the foreground window
*/
2969 user_handle_t previous
; /* handle to the previous foreground window
*/
2970 int send_msg_old
; /* whether we have to send a msg to the old window
*/
2971 int send_msg_new
; /* whether we have to send a msg to the new window
*/
2974 /* Set the current thread focus window
*/
2975 @
REQ(set_focus_window
)
2976 user_handle_t handle
; /* handle to the focus window
*/
2978 user_handle_t previous
; /* handle to the previous focus window
*/
2981 /* Set the current thread active window
*/
2982 @
REQ(set_active_window
)
2983 user_handle_t handle
; /* handle to the active window
*/
2985 user_handle_t previous
; /* handle to the previous active window
*/
2988 /* Set the current thread capture window
*/
2989 @
REQ(set_capture_window
)
2990 user_handle_t handle
; /* handle to the capture window
*/
2991 unsigned int flags
; /* capture
flags (see below
) */
2993 user_handle_t previous
; /* handle to the previous capture window
*/
2994 user_handle_t full_handle
; /* full
32-bit handle of new capture window
*/
2996 #define CAPTURE_MENU
0x01 /* capture is for a menu
*/
2997 #define CAPTURE_MOVESIZE
0x02 /* capture is for moving
/resizing
*/
3000 /* Set the current thread caret window
*/
3001 @
REQ(set_caret_window
)
3002 user_handle_t handle
; /* handle to the caret window
*/
3003 int width
; /* caret width
*/
3004 int height
; /* caret height
*/
3006 user_handle_t previous
; /* handle to the previous caret window
*/
3007 rectangle_t old_rect
; /* previous caret rectangle
*/
3008 int old_hide
; /* previous hide count
*/
3009 int old_state
; /* previous caret
state (1=on
, 0=off
) */
3013 /* Set the current thread caret information
*/
3014 @
REQ(set_caret_info
)
3015 unsigned int flags
; /* caret
flags (see below
) */
3016 user_handle_t handle
; /* handle to the caret window
*/
3017 int x
; /* caret x position
*/
3018 int y
; /* caret y position
*/
3019 int hide
; /* increment for hide
count (can be negative to show it
) */
3020 int state
; /* caret
state (see below
) */
3022 user_handle_t full_handle
; /* handle to the current caret window
*/
3023 rectangle_t old_rect
; /* previous caret rectangle
*/
3024 int old_hide
; /* previous hide count
*/
3025 int old_state
; /* previous caret
state (1=on
, 0=off
) */
3027 #define SET_CARET_POS
0x01 /* set the caret position from x
,y
*/
3028 #define SET_CARET_HIDE
0x02 /* increment the caret hide count
*/
3029 #define SET_CARET_STATE
0x04 /* set the caret on
/off state
*/
3032 CARET_STATE_OFF
, /* off
*/
3033 CARET_STATE_ON
, /* on
*/
3034 CARET_STATE_TOGGLE
, /* toggle current state
*/
3035 CARET_STATE_ON_IF_MOVED
/* on if the position differs
, unchanged otherwise
*/
3039 /* Set a window hook
*/
3041 int id
; /* id of the hook
*/
3042 process_id_t pid
; /* id of process to set the hook into
*/
3043 thread_id_t tid
; /* id of thread to set the hook into
*/
3046 client_ptr_t proc
; /* hook procedure
*/
3048 int unicode
; /* is it a unicode hook?
*/
3049 VARARG(module
,unicode_str
); /* module name
*/
3051 user_handle_t handle
; /* handle to the hook
*/
3052 unsigned int active_hooks
; /* active hooks bitmap
*/
3056 /* Remove a window hook
*/
3058 user_handle_t handle
; /* handle to the hook
*/
3059 client_ptr_t proc
; /* hook procedure if handle is
0 */
3060 int id
; /* id of the hook if handle is
0 */
3062 unsigned int active_hooks
; /* active hooks bitmap
*/
3066 /* Start calling a hook chain
*/
3067 @
REQ(start_hook_chain
)
3068 int id
; /* id of the hook
*/
3069 int event
; /* signalled event
*/
3070 user_handle_t window
; /* handle to the event window
*/
3071 int object_id
; /* object id for out of context winevent
*/
3072 int child_id
; /* child id for out of context winevent
*/
3074 user_handle_t handle
; /* handle to the next hook
*/
3075 process_id_t pid
; /* process id for low
-level keyboard
/mouse hooks
*/
3076 thread_id_t tid
; /* thread id for low
-level keyboard
/mouse hooks
*/
3077 int unicode
; /* is it a unicode hook?
*/
3078 client_ptr_t proc
; /* hook procedure
*/
3079 unsigned int active_hooks
; /* active hooks bitmap
*/
3080 VARARG(module
,unicode_str
); /* module name
*/
3084 /* Finished calling a hook chain
*/
3085 @
REQ(finish_hook_chain
)
3086 int id
; /* id of the hook
*/
3090 /* Get the hook information
*/
3092 user_handle_t handle
; /* handle to the current hook
*/
3093 int get_next
; /* do we want info about current or next hook?
*/
3094 int event
; /* signalled event
*/
3095 user_handle_t window
; /* handle to the event window
*/
3096 int object_id
; /* object id for out of context winevent
*/
3097 int child_id
; /* child id for out of context winevent
*/
3099 user_handle_t handle
; /* handle to the hook
*/
3100 int id
; /* id of the hook
*/
3101 process_id_t pid
; /* process id for low
-level keyboard
/mouse hooks
*/
3102 thread_id_t tid
; /* thread id for low
-level keyboard
/mouse hooks
*/
3103 client_ptr_t proc
; /* hook procedure
*/
3104 int unicode
; /* is it a unicode hook?
*/
3105 VARARG(module
,unicode_str
); /* module name
*/
3109 /* Create a window class
*/
3111 int local
; /* is it a local class?
*/
3112 atom_t atom
; /* class atom
*/
3113 unsigned int style
; /* class style
*/
3114 mod_handle_t instance
; /* module instance
*/
3115 int extra
; /* number of extra class bytes
*/
3116 int win_extra
; /* number of window extra bytes
*/
3117 client_ptr_t client_ptr
; /* pointer to class in client address space
*/
3118 VARARG(name
,unicode_str
); /* class name
*/
3120 atom_t atom
; /* resulting class atom
*/
3124 /* Destroy a window class
*/
3126 atom_t atom
; /* class atom
*/
3127 mod_handle_t instance
; /* module instance
*/
3128 VARARG(name
,unicode_str
); /* class name
*/
3130 client_ptr_t client_ptr
; /* pointer to class in client address space
*/
3134 /* Set some information in a class
*/
3135 @
REQ(set_class_info
)
3136 user_handle_t window
; /* handle to the window
*/
3137 unsigned int flags
; /* flags for info to
set (see below
) */
3138 atom_t atom
; /* class atom
*/
3139 unsigned int style
; /* class style
*/
3140 int win_extra
; /* number of window extra bytes
*/
3141 mod_handle_t instance
; /* module instance
*/
3142 int extra_offset
; /* offset to set in extra bytes
*/
3143 data_size_t extra_size
; /* size to set in extra bytes
*/
3144 lparam_t extra_value
; /* value to set in extra bytes
*/
3146 atom_t old_atom
; /* previous class atom
*/
3147 unsigned int old_style
; /* previous class style
*/
3148 int old_extra
; /* previous number of class extra bytes
*/
3149 int old_win_extra
; /* previous number of window extra bytes
*/
3150 mod_handle_t old_instance
; /* previous module instance
*/
3151 lparam_t old_extra_value
; /* old value in extra bytes
*/
3153 #define SET_CLASS_ATOM
0x0001
3154 #define SET_CLASS_STYLE
0x0002
3155 #define SET_CLASS_WINEXTRA
0x0004
3156 #define SET_CLASS_INSTANCE
0x0008
3157 #define SET_CLASS_EXTRA
0x0010
3160 /* Open the clipboard
*/
3161 @
REQ(open_clipboard
)
3162 user_handle_t window
; /* clipboard window
*/
3164 user_handle_t owner
; /* current clipboard owner
*/
3168 /* Close the clipboard
*/
3169 @
REQ(close_clipboard
)
3171 user_handle_t viewer
; /* first clipboard viewer
*/
3172 user_handle_t owner
; /* current clipboard owner
*/
3176 /* Empty the clipboard and grab ownership
*/
3177 @
REQ(empty_clipboard
)
3181 /* Add a data format to the clipboard
*/
3182 @
REQ(set_clipboard_data
)
3183 unsigned int format
; /* clipboard format of the data
*/
3184 unsigned int lcid
; /* locale id to use for synthesizing text formats
*/
3185 VARARG(data
,bytes
); /* data contents
*/
3187 unsigned int seqno
; /* sequence number for the set data
*/
3191 /* Fetch a data format from the clipboard
*/
3192 @
REQ(get_clipboard_data
)
3193 unsigned int format
; /* clipboard format of the data
*/
3194 int cached
; /* do we already have it in the client
-side cache?
*/
3195 unsigned int seqno
; /* sequence number for the data in the cache
*/
3197 unsigned int from
; /* for synthesized data
, format to generate it from
*/
3198 user_handle_t owner
; /* clipboard owner for delayed
-rendered formats
*/
3199 unsigned int seqno
; /* sequence number for the originally set data
*/
3200 data_size_t total
; /* total data size
*/
3201 VARARG(data
,bytes
); /* data contents
*/
3205 /* Retrieve a list of available formats
*/
3206 @
REQ(get_clipboard_formats
)
3207 unsigned int format
; /* specific format to query
, return all if
0 */
3209 unsigned int count
; /* count of available formats
*/
3210 VARARG(formats
,uints
); /* array of available formats
*/
3214 /* Retrieve the next available format
*/
3215 @
REQ(enum_clipboard_formats
)
3216 unsigned int previous
; /* previous format
, or first if
0 */
3218 unsigned int format
; /* next format
*/
3222 /* Release ownership of the clipboard
*/
3223 @
REQ(release_clipboard
)
3224 user_handle_t owner
; /* clipboard owner to release
*/
3226 user_handle_t viewer
; /* first clipboard viewer
*/
3227 user_handle_t owner
; /* current clipboard owner
*/
3231 /* Get clipboard information
*/
3232 @
REQ(get_clipboard_info
)
3234 user_handle_t window
; /* clipboard window
*/
3235 user_handle_t owner
; /* clipboard owner
*/
3236 user_handle_t viewer
; /* clipboard viewer
*/
3237 unsigned int seqno
; /* current sequence number
*/
3241 /* Set the clipboard viewer window
*/
3242 @
REQ(set_clipboard_viewer
)
3243 user_handle_t viewer
; /* clipboard viewer
*/
3244 user_handle_t previous
; /* if non
-zero
, check that this was the previous viewer
*/
3246 user_handle_t old_viewer
; /* previous clipboard viewer
*/
3247 user_handle_t owner
; /* clipboard owner
*/
3251 /* Add a clipboard listener window
*/
3252 @
REQ(add_clipboard_listener
)
3253 user_handle_t window
; /* clipboard listener window
*/
3257 /* Remove a clipboard listener window
*/
3258 @
REQ(remove_clipboard_listener
)
3259 user_handle_t window
; /* clipboard listener window
*/
3263 /* Open a security token
*/
3265 obj_handle_t handle
; /* handle to the thread or process
*/
3266 unsigned int access
; /* access rights to the new token
*/
3267 unsigned int attributes
;/* object attributes
*/
3268 unsigned int flags
; /* flags (see below
) */
3270 obj_handle_t token
; /* handle to the token
*/
3272 #define OPEN_TOKEN_THREAD
1
3273 #define OPEN_TOKEN_AS_SELF
2
3276 /* Set
/get the global windows
*/
3277 @
REQ(set_global_windows
)
3278 unsigned int flags
; /* flags for fields to
set (see below
) */
3279 user_handle_t shell_window
; /* handle to the new shell window
*/
3280 user_handle_t shell_listview
; /* handle to the new shell listview window
*/
3281 user_handle_t progman_window
; /* handle to the new program manager window
*/
3282 user_handle_t taskman_window
; /* handle to the new task manager window
*/
3284 user_handle_t old_shell_window
; /* handle to the shell window
*/
3285 user_handle_t old_shell_listview
; /* handle to the shell listview window
*/
3286 user_handle_t old_progman_window
; /* handle to the new program manager window
*/
3287 user_handle_t old_taskman_window
; /* handle to the new task manager window
*/
3289 #define SET_GLOBAL_SHELL_WINDOWS
0x01 /* set both main shell and listview windows
*/
3290 #define SET_GLOBAL_PROGMAN_WINDOW
0x02
3291 #define SET_GLOBAL_TASKMAN_WINDOW
0x04
3293 /* Adjust the privileges held by a token
*/
3294 @
REQ(adjust_token_privileges
)
3295 obj_handle_t handle
; /* handle to the token
*/
3296 int disable_all
; /* disable all privileges?
*/
3297 int get_modified_state
; /* get modified privileges?
*/
3298 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* privileges to enable
/disable
/remove
*/
3300 unsigned int len
; /* total length in bytes required to store token privileges
*/
3301 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* modified privileges
*/
3304 /* Retrieves the set of privileges held by or available to a token
*/
3305 @
REQ(get_token_privileges
)
3306 obj_handle_t handle
; /* handle to the token
*/
3308 unsigned int len
; /* total length in bytes required to store token privileges
*/
3309 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* privileges held by or available to a token
*/
3312 /* Check the token has the required privileges
*/
3313 @
REQ(check_token_privileges
)
3314 obj_handle_t handle
; /* handle to the token
*/
3315 int all_required
; /* are all the privileges required for the check to succeed?
*/
3316 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* privileges to check
*/
3318 int has_privileges
; /* does the token have the required privileges?
*/
3319 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* privileges held by or available to a token
*/
3322 @
REQ(duplicate_token
)
3323 obj_handle_t handle
; /* handle to the token to duplicate
*/
3324 unsigned int access
; /* access rights to the new token
*/
3325 unsigned int attributes
; /* object attributes
*/
3326 int primary
; /* is the new token to be a primary one?
*/
3327 int impersonation_level
; /* impersonation level of the new token
*/
3329 obj_handle_t new_handle
; /* duplicated handle
*/
3333 obj_handle_t handle
; /* handle to the token
*/
3334 unsigned int desired_access
; /* desired access to the object
*/
3335 unsigned int mapping_read
; /* mapping from generic read to specific rights
*/
3336 unsigned int mapping_write
; /* mapping from generic write to specific rights
*/
3337 unsigned int mapping_execute
; /* mapping from generic execute to specific rights
*/
3338 unsigned int mapping_all
; /* mapping from generic all to specific rights
*/
3339 VARARG(sd
,security_descriptor
); /* security descriptor to check
*/
3341 unsigned int access_granted
; /* access rights actually granted
*/
3342 unsigned int access_status
; /* was access granted?
*/
3343 unsigned int privileges_len
; /* length needed to store privileges
*/
3344 VARARG(privileges
,LUID_AND_ATTRIBUTES
); /* privileges used during access check
*/
3348 obj_handle_t handle
; /* handle to the token
*/
3349 unsigned int which_sid
; /* which SID to retrieve from the token
*/
3351 data_size_t sid_len
; /* length needed to store sid
*/
3352 VARARG(sid
,SID
); /* the sid specified by which_sid from the token
*/
3355 @
REQ(get_token_groups
)
3356 obj_handle_t handle
; /* handle to the token
*/
3358 data_size_t user_len
; /* length needed to store user
*/
3359 VARARG(user
,token_groups
); /* groups the token
's user belongs to */
3362 @REQ(get_token_default_dacl)
3363 obj_handle_t handle; /* handle to the token */
3365 data_size_t acl_len; /* length needed to store access control list */
3366 VARARG(acl,ACL); /* access control list */
3369 @REQ(set_token_default_dacl)
3370 obj_handle_t handle; /* handle to the token */
3371 VARARG(acl,ACL); /* default dacl to set */
3374 @REQ(set_security_object)
3375 obj_handle_t handle; /* handle to the object */
3376 unsigned int security_info; /* which parts of security descriptor to set */
3377 VARARG(sd,security_descriptor); /* security descriptor to set */
3380 @REQ(get_security_object)
3381 obj_handle_t handle; /* handle to the object */
3382 unsigned int security_info; /* which parts of security descriptor to get */
3384 unsigned int sd_len; /* buffer size needed for sd */
3385 VARARG(sd,security_descriptor); /* retrieved security descriptor */
3392 obj_handle_t handle;
3393 unsigned int access;
3396 /* Return a list of all opened handles */
3397 @REQ(get_system_handles)
3399 unsigned int count; /* number of handles */
3400 VARARG(data,handle_infos); /* array of handle_infos */
3404 /* Create a mailslot */
3405 @REQ(create_mailslot)
3406 unsigned int access; /* wanted access rights */
3407 timeout_t read_timeout;
3408 unsigned int max_msgsize;
3409 VARARG(objattr,object_attributes); /* object attributes */
3411 obj_handle_t handle; /* handle to the mailslot */
3415 /* Set mailslot information */
3416 @REQ(set_mailslot_info)
3417 obj_handle_t handle; /* handle to the mailslot */
3418 timeout_t read_timeout;
3421 timeout_t read_timeout;
3422 unsigned int max_msgsize;
3424 #define MAILSLOT_SET_READ_TIMEOUT 1
3427 /* Create a directory object */
3428 @REQ(create_directory)
3429 unsigned int access; /* access flags */
3430 VARARG(objattr,object_attributes); /* object attributes */
3432 obj_handle_t handle; /* handle to the directory */
3436 /* Open a directory object */
3437 @REQ(open_directory)
3438 unsigned int access; /* access flags */
3439 unsigned int attributes; /* object attributes */
3440 obj_handle_t rootdir; /* root directory */
3441 VARARG(directory_name,unicode_str); /* Directory name */
3443 obj_handle_t handle; /* handle to the directory */
3447 /* Get a directory entry by index */
3448 @REQ(get_directory_entry)
3449 obj_handle_t handle; /* handle to the directory */
3450 unsigned int index; /* entry index */
3452 data_size_t name_len; /* length of the entry name in bytes */
3453 VARARG(name,unicode_str,name_len); /* entry name */
3454 VARARG(type,unicode_str); /* entry type */
3458 /* Create a symbolic link object */
3459 @REQ(create_symlink)
3460 unsigned int access; /* access flags */
3461 VARARG(objattr,object_attributes); /* object attributes */
3462 VARARG(target_name,unicode_str); /* target name */
3464 obj_handle_t handle; /* handle to the symlink */
3468 /* Open a symbolic link object */
3470 unsigned int access; /* access flags */
3471 unsigned int attributes; /* object attributes */
3472 obj_handle_t rootdir; /* root directory */
3473 VARARG(name,unicode_str); /* symlink name */
3475 obj_handle_t handle; /* handle to the symlink */
3479 /* Query a symbolic link object */
3481 obj_handle_t handle; /* handle to the symlink */
3483 data_size_t total; /* total needed size for name */
3484 VARARG(target_name,unicode_str); /* target name */
3488 /* Query basic object information */
3489 @REQ(get_object_info)
3490 obj_handle_t handle; /* handle to the object */
3492 unsigned int access; /* granted access mask */
3493 unsigned int ref_count; /* object ref count */
3494 unsigned int handle_count; /* object handle count */
3495 data_size_t total; /* total needed size for name */
3496 VARARG(name,unicode_str); /* object name */
3500 /* Query object type name information */
3501 @REQ(get_object_type)
3502 obj_handle_t handle; /* handle to the object */
3504 data_size_t total; /* needed size for type name */
3505 VARARG(type,unicode_str); /* type name */
3509 /* Unlink a named object */
3511 obj_handle_t handle; /* handle to the object */
3515 /* Query the impersonation level of an impersonation token */
3516 @REQ(get_token_impersonation_level)
3517 obj_handle_t handle; /* handle to the object */
3519 int impersonation_level; /* impersonation level of the impersonation token */
3522 /* Allocate a locally-unique identifier */
3523 @REQ(allocate_locally_unique_id)
3529 /* Create a device manager */
3530 @REQ(create_device_manager)
3531 unsigned int access; /* wanted access rights */
3532 unsigned int attributes; /* object attributes */
3534 obj_handle_t handle; /* handle to the device */
3538 /* Create a device */
3540 unsigned int access; /* wanted access rights */
3541 unsigned int attributes; /* object attributes */
3542 obj_handle_t rootdir; /* root directory */
3543 client_ptr_t user_ptr; /* opaque ptr for use by client */
3544 obj_handle_t manager; /* device manager */
3545 VARARG(name,unicode_str); /* object name */
3547 obj_handle_t handle; /* handle to the device */
3551 /* Delete a device */
3553 obj_handle_t handle; /* handle to the device */
3557 /* Retrieve the next pending device irp request */
3558 @REQ(get_next_device_request)
3559 obj_handle_t manager; /* handle to the device manager */
3560 obj_handle_t prev; /* handle to the previous irp */
3561 unsigned int status; /* status of the previous irp */
3563 irp_params_t params; /* irp parameters */
3564 obj_handle_t next; /* handle to the next irp */
3565 process_id_t client_pid; /* pid of process calling irp */
3566 thread_id_t client_tid; /* tid of thread calling irp */
3567 data_size_t in_size; /* total needed input size */
3568 data_size_t out_size; /* needed output size */
3569 VARARG(next_data,bytes); /* input data of the next irp */
3573 /* Make the current process a system process */
3574 @REQ(make_process_system)
3576 obj_handle_t event; /* event signaled when all user processes have exited */
3580 /* Get detailed fixed-size information about a token */
3581 @REQ(get_token_statistics)
3582 obj_handle_t handle; /* handle to the object */
3584 luid_t token_id; /* locally-unique identifier of the token */
3585 luid_t modified_id; /* locally-unique identifier of the modified version of the token */
3586 int primary; /* is the token primary or impersonation? */
3587 int impersonation_level; /* level of impersonation */
3588 int group_count; /* the number of groups the token is a member of */
3589 int privilege_count; /* the number of privileges the token has */
3593 /* Create I/O completion port */
3594 @REQ(create_completion)
3595 unsigned int access; /* desired access to a port */
3596 unsigned int concurrent; /* max number of concurrent active threads */
3597 VARARG(objattr,object_attributes); /* object attributes */
3599 obj_handle_t handle; /* port handle */
3603 /* Open I/O completion port */
3604 @REQ(open_completion)
3605 unsigned int access; /* desired access to a port */
3606 unsigned int attributes; /* object attributes */
3607 obj_handle_t rootdir; /* root directory */
3608 VARARG(filename,unicode_str); /* port name */
3610 obj_handle_t handle; /* port handle */
3614 /* add completion to completion port */
3615 @REQ(add_completion)
3616 obj_handle_t handle; /* port handle */
3617 apc_param_t ckey; /* completion key */
3618 apc_param_t cvalue; /* completion value */
3619 apc_param_t information; /* IO_STATUS_BLOCK Information */
3620 unsigned int status; /* completion result */
3624 /* get completion from completion port queue */
3625 @REQ(remove_completion)
3626 obj_handle_t handle; /* port handle */
3628 apc_param_t ckey; /* completion key */
3629 apc_param_t cvalue; /* completion value */
3630 apc_param_t information; /* IO_STATUS_BLOCK Information */
3631 unsigned int status; /* completion result */
3635 /* get completion queue depth */
3636 @REQ(query_completion)
3637 obj_handle_t handle; /* port handle */
3639 unsigned int depth; /* completion queue depth */
3643 /* associate object with completion port */
3644 @REQ(set_completion_info)
3645 obj_handle_t handle; /* object handle */
3646 apc_param_t ckey; /* completion key */
3647 obj_handle_t chandle; /* port handle */
3651 /* check for associated completion and push msg */
3652 @REQ(add_fd_completion)
3653 obj_handle_t handle; /* async' object
*/
3654 apc_param_t cvalue
; /* completion value
*/
3655 apc_param_t information
; /* IO_STATUS_BLOCK Information
*/
3656 unsigned int status
; /* completion status
*/
3660 /* set fd disposition information
*/
3661 @
REQ(set_fd_disp_info
)
3662 obj_handle_t handle
; /* handle to a file or directory
*/
3663 int unlink
; /* whether to unlink file on close
*/
3667 /* set fd name information
*/
3668 @
REQ(set_fd_name_info
)
3669 obj_handle_t handle
; /* handle to a file or directory
*/
3670 obj_handle_t rootdir
; /* root directory
*/
3671 int link
; /* link instead of renaming
*/
3672 VARARG(filename
,string
); /* new file name
*/
3676 /* Retrieve layered info for a window
*/
3677 @
REQ(get_window_layered_info
)
3678 user_handle_t handle
; /* handle to the window
*/
3680 unsigned int color_key
; /* color key
*/
3681 unsigned int alpha
; /* alpha (0.
.255) */
3682 unsigned int flags
; /* LWA_
* flags
*/
3686 /* Set layered info for a window
*/
3687 @
REQ(set_window_layered_info
)
3688 user_handle_t handle
; /* handle to the window
*/
3689 unsigned int color_key
; /* color key
*/
3690 unsigned int alpha
; /* alpha (0.
.255) */
3691 unsigned int flags
; /* LWA_
* flags
*/
3695 /* Allocate an arbitrary user handle
*/
3696 @
REQ(alloc_user_handle
)
3698 user_handle_t handle
; /* allocated handle
*/
3702 /* Free an arbitrary user handle
*/
3703 @
REQ(free_user_handle
)
3704 user_handle_t handle
; /* handle to free
*/
3708 /* Set
/get the current cursor
*/
3710 unsigned int flags
; /* flags for fields to
set (see below
) */
3711 user_handle_t handle
; /* handle to the cursor
*/
3712 int show_count
; /* show count increment
/decrement
*/
3713 int x
; /* cursor position
*/
3715 rectangle_t clip
; /* cursor clip rectangle
*/
3716 unsigned int clip_msg
; /* message to post on cursor clip changes
*/
3718 user_handle_t prev_handle
; /* previous handle
*/
3719 int prev_count
; /* previous show count
*/
3720 int prev_x
; /* previous position
*/
3722 int new_x
; /* new position
*/
3724 rectangle_t new_clip
; /* new clip rectangle
*/
3725 unsigned int last_change
; /* time of last position change
*/
3727 #define SET_CURSOR_HANDLE
0x01
3728 #define SET_CURSOR_COUNT
0x02
3729 #define SET_CURSOR_POS
0x04
3730 #define SET_CURSOR_CLIP
0x08
3731 #define SET_CURSOR_NOCLIP
0x10
3734 /* Modify the list of registered rawinput devices
*/
3735 @
REQ(update_rawinput_devices
)
3736 VARARG(devices
,rawinput_devices
);
3740 /* Retrieve the suspended context of a thread
*/
3741 @
REQ(get_suspend_context
)
3743 VARARG(context
,context
); /* thread context
*/
3747 /* Store the suspend context of a thread
*/
3748 @
REQ(set_suspend_context
)
3749 VARARG(context
,context
); /* thread context
*/
3753 /* Create a new job object
*/
3755 unsigned int access
; /* wanted access rights
*/
3756 VARARG(objattr
,object_attributes
); /* object attributes
*/
3758 obj_handle_t handle
; /* handle to the job
*/
3762 /* Open a job object
*/
3764 unsigned int access
; /* wanted access rights
*/
3765 unsigned int attributes
; /* object attributes
*/
3766 obj_handle_t rootdir
; /* root directory
*/
3767 VARARG(name
,unicode_str
); /* object name
*/
3769 obj_handle_t handle
; /* handle to the job
*/
3773 /* Assign a job object to a process
*/
3775 obj_handle_t job
; /* handle to the job
*/
3776 obj_handle_t process
; /* handle to the process
*/
3780 /* Check if a process is associated with a job
*/
3781 @
REQ(process_in_job
)
3782 obj_handle_t job
; /* handle to the job
*/
3783 obj_handle_t process
; /* handle to the process
*/
3787 /* Set limit flags on a job
*/
3788 @
REQ(set_job_limits
)
3789 obj_handle_t handle
; /* handle to the job
*/
3790 unsigned int limit_flags
; /* new limit flags
*/
3794 /* Set new completion port for a job
*/
3795 @
REQ(set_job_completion_port
)
3796 obj_handle_t job
; /* handle to the job
*/
3797 obj_handle_t port
; /* handle to the completion port
*/
3798 client_ptr_t key
; /* key to send with completion messages
*/
3802 /* Terminate all processes associated with the job
*/
3804 obj_handle_t handle
; /* handle to the job
*/
3805 int status
; /* process exit code
*/