kernel32: Display correct parameters in comm traces.
[wine/wine64.git] / server / protocol.def
blob2073a20990a160328a5902469a003aa8b4c31c06
1 /* -*- C -*-
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 */
27 #include <stdarg.h>
28 #include <stdlib.h>
29 #include <time.h>
31 #include <windef.h>
32 #include <winbase.h>
34 typedef void *obj_handle_t;
35 typedef void *user_handle_t;
36 typedef unsigned short atom_t;
37 typedef unsigned int process_id_t;
38 typedef unsigned int thread_id_t;
39 typedef unsigned int data_size_t;
41 struct request_header
43 int req; /* request code */
44 data_size_t request_size; /* request variable part size */
45 data_size_t reply_size; /* reply variable part maximum size */
48 struct reply_header
50 unsigned int error; /* error result */
51 data_size_t reply_size; /* reply variable part size */
54 /* placeholder structure for the maximum allowed request size */
55 /* this is used to construct the generic_request union */
56 struct request_max_size
58 int pad[16]; /* the max request size is 16 ints */
61 #define FIRST_USER_HANDLE 0x0020 /* first possible value for low word of user handle */
62 #define LAST_USER_HANDLE 0xffef /* last possible value for low word of user handle */
65 /* definitions of the event data depending on the event code */
66 struct debug_event_exception
68 EXCEPTION_RECORD record; /* exception record */
69 int first; /* first chance exception? */
71 struct debug_event_create_thread
73 obj_handle_t handle; /* handle to the new thread */
74 void *teb; /* thread teb (in debugged process address space) */
75 void *start; /* thread startup routine */
77 struct debug_event_create_process
79 obj_handle_t file; /* handle to the process exe file */
80 obj_handle_t process; /* handle to the new process */
81 obj_handle_t thread; /* handle to the new thread */
82 void *base; /* base of executable image */
83 int dbg_offset; /* offset of debug info in file */
84 int dbg_size; /* size of debug info */
85 void *teb; /* thread teb (in debugged process address space) */
86 void *start; /* thread startup routine */
87 void *name; /* image name (optional) */
88 int unicode; /* is it Unicode? */
90 struct debug_event_exit
92 int exit_code; /* thread or process exit code */
94 struct debug_event_load_dll
96 obj_handle_t handle; /* file handle for the dll */
97 void *base; /* base address of the dll */
98 int dbg_offset; /* offset of debug info in file */
99 int dbg_size; /* size of debug info */
100 void *name; /* image name (optional) */
101 int unicode; /* is it Unicode? */
103 struct debug_event_unload_dll
105 void *base; /* base address of the dll */
107 struct debug_event_output_string
109 void *string; /* string to display (in debugged process address space) */
110 int unicode; /* is it Unicode? */
111 int length; /* string length */
113 struct debug_event_rip_info
115 int error; /* ??? */
116 int type; /* ??? */
118 union debug_event_data
120 struct debug_event_exception exception;
121 struct debug_event_create_thread create_thread;
122 struct debug_event_create_process create_process;
123 struct debug_event_exit exit;
124 struct debug_event_load_dll load_dll;
125 struct debug_event_unload_dll unload_dll;
126 struct debug_event_output_string output_string;
127 struct debug_event_rip_info rip_info;
130 /* debug event data */
131 typedef struct
133 int code; /* event code */
134 union debug_event_data info; /* event information */
135 } debug_event_t;
137 /* structure used in sending an fd from client to server */
138 struct send_fd
140 thread_id_t tid; /* thread id */
141 int fd; /* file descriptor on client-side */
144 /* structure sent by the server on the wait fifo */
145 struct wake_up_reply
147 void *cookie; /* magic cookie that was passed in select_request */
148 int signaled; /* wait result */
151 /* structure for absolute timeouts */
152 typedef struct
154 int sec; /* seconds since Unix epoch */
155 int usec; /* microseconds */
156 } abs_time_t;
158 /* structure returned in the list of window properties */
159 typedef struct
161 atom_t atom; /* property atom */
162 short string; /* was atom a string originally? */
163 obj_handle_t handle; /* handle stored in property */
164 } property_data_t;
166 /* structure to specify window rectangles */
167 typedef struct
169 int left;
170 int top;
171 int right;
172 int bottom;
173 } rectangle_t;
175 /* structures for extra message data */
177 struct callback_msg_data
179 void *callback; /* callback function */
180 unsigned long data; /* user data for callback */
181 unsigned long result; /* message result */
184 struct winevent_msg_data
186 user_handle_t hook; /* hook handle */
187 thread_id_t tid; /* thread id */
188 void *hook_proc; /* hook proc address */
189 /* followed by module name if any */
192 typedef union
194 unsigned char bytes[1]; /* raw data for sent messages */
195 struct callback_msg_data callback;
196 struct winevent_msg_data winevent;
197 } message_data_t;
199 /* structure for console char/attribute info */
200 typedef struct
202 WCHAR ch;
203 unsigned short attr;
204 } char_info_t;
206 #define MAX_ACL_LEN 65535
208 struct security_descriptor
210 unsigned int control; /* SE_ flags */
211 data_size_t owner_len;
212 data_size_t group_len;
213 data_size_t sacl_len;
214 data_size_t dacl_len;
215 /* VARARGS(owner,SID); */
216 /* VARARGS(group,SID); */
217 /* VARARGS(sacl,ACL); */
218 /* VARARGS(dacl,ACL); */
221 struct token_groups
223 unsigned int count;
224 /* unsigned int attributes[count]; */
225 /* VARARGS(sids,SID); */
228 enum apc_type
230 APC_NONE,
231 APC_USER,
232 APC_TIMER,
233 APC_ASYNC_IO,
234 APC_VIRTUAL_ALLOC,
235 APC_VIRTUAL_FREE,
236 APC_VIRTUAL_QUERY,
237 APC_VIRTUAL_PROTECT,
238 APC_VIRTUAL_FLUSH,
239 APC_VIRTUAL_LOCK,
240 APC_VIRTUAL_UNLOCK,
241 APC_MAP_VIEW,
242 APC_UNMAP_VIEW,
243 APC_CREATE_THREAD
246 typedef union
248 enum apc_type type;
249 struct
251 enum apc_type type; /* APC_USER */
252 void (__stdcall *func)(unsigned long,unsigned long,unsigned long);
253 unsigned long args[3]; /* arguments for user function */
254 } user;
255 struct
257 enum apc_type type; /* APC_TIMER */
258 void (__stdcall *func)(void*, unsigned int, unsigned int);
259 abs_time_t time; /* absolute time of expiration */
260 void *arg; /* user argument */
261 } timer;
262 struct
264 enum apc_type type; /* APC_ASYNC_IO */
265 void (__stdcall *func)(void*, void*, unsigned int);
266 void *user; /* user pointer */
267 void *sb; /* status block */
268 unsigned int status; /* I/O status */
269 } async_io;
270 struct
272 enum apc_type type; /* APC_VIRTUAL_ALLOC */
273 void *addr; /* requested address */
274 unsigned long size; /* allocation size */
275 unsigned int zero_bits; /* allocation alignment */
276 unsigned int op_type; /* type of operation */
277 unsigned int prot; /* memory protection flags */
278 } virtual_alloc;
279 struct
281 enum apc_type type; /* APC_VIRTUAL_FREE */
282 void *addr; /* requested address */
283 unsigned long size; /* allocation size */
284 unsigned int op_type; /* type of operation */
285 } virtual_free;
286 struct
288 enum apc_type type; /* APC_VIRTUAL_QUERY */
289 const void *addr; /* requested address */
290 } virtual_query;
291 struct
293 enum apc_type type; /* APC_VIRTUAL_PROTECT */
294 void *addr; /* requested address */
295 unsigned long size; /* requested address */
296 unsigned int prot; /* new protection flags */
297 } virtual_protect;
298 struct
300 enum apc_type type; /* APC_VIRTUAL_FLUSH */
301 const void *addr; /* requested address */
302 unsigned long size; /* requested address */
303 } virtual_flush;
304 struct
306 enum apc_type type; /* APC_VIRTUAL_LOCK */
307 void *addr; /* requested address */
308 unsigned long size; /* requested address */
309 } virtual_lock;
310 struct
312 enum apc_type type; /* APC_VIRTUAL_UNLOCK */
313 void *addr; /* requested address */
314 unsigned long size; /* requested address */
315 } virtual_unlock;
316 struct
318 enum apc_type type; /* APC_MAP_VIEW */
319 obj_handle_t handle; /* mapping handle */
320 void *addr; /* requested address */
321 unsigned long size; /* allocation size */
322 unsigned int offset_low;/* file offset */
323 unsigned int offset_high;
324 unsigned int zero_bits; /* allocation alignment */
325 unsigned int alloc_type;/* allocation type */
326 unsigned int prot; /* memory protection flags */
327 } map_view;
328 struct
330 enum apc_type type; /* APC_UNMAP_VIEW */
331 void *addr; /* view address */
332 } unmap_view;
333 struct
335 enum apc_type type; /* APC_CREATE_THREAD */
336 void (__stdcall *func)(void*); /* start function */
337 void *arg; /* argument for start function */
338 unsigned long reserve; /* reserve size for thread stack */
339 unsigned long commit; /* commit size for thread stack */
340 int suspend; /* suspended thread? */
341 } create_thread;
342 } apc_call_t;
344 typedef union
346 enum apc_type type;
347 struct
349 enum apc_type type; /* APC_VIRTUAL_ALLOC */
350 unsigned int status; /* status returned by call */
351 void *addr; /* resulting address */
352 unsigned long size; /* resulting size */
353 } virtual_alloc;
354 struct
356 enum apc_type type; /* APC_VIRTUAL_FREE */
357 unsigned int status; /* status returned by call */
358 void *addr; /* resulting address */
359 unsigned long size; /* resulting size */
360 } virtual_free;
361 struct
363 enum apc_type type; /* APC_VIRTUAL_QUERY */
364 unsigned int status; /* status returned by call */
365 void *base; /* resulting base address */
366 void *alloc_base;/* resulting allocation base */
367 unsigned long size; /* resulting region size */
368 unsigned int state; /* resulting region state */
369 unsigned int prot; /* resulting region protection */
370 unsigned int alloc_prot;/* resulting allocation protection */
371 unsigned int alloc_type;/* resulting region allocation type */
372 } virtual_query;
373 struct
375 enum apc_type type; /* APC_VIRTUAL_PROTECT */
376 unsigned int status; /* status returned by call */
377 void *addr; /* resulting address */
378 unsigned long size; /* resulting size */
379 unsigned int prot; /* old protection flags */
380 } virtual_protect;
381 struct
383 enum apc_type type; /* APC_VIRTUAL_FLUSH */
384 unsigned int status; /* status returned by call */
385 const void *addr; /* resulting address */
386 unsigned long size; /* resulting size */
387 } virtual_flush;
388 struct
390 enum apc_type type; /* APC_VIRTUAL_LOCK */
391 unsigned int status; /* status returned by call */
392 void *addr; /* resulting address */
393 unsigned long size; /* resulting size */
394 } virtual_lock;
395 struct
397 enum apc_type type; /* APC_VIRTUAL_UNLOCK */
398 unsigned int status; /* status returned by call */
399 void *addr; /* resulting address */
400 unsigned long size; /* resulting size */
401 } virtual_unlock;
402 struct
404 enum apc_type type; /* APC_MAP_VIEW */
405 unsigned int status; /* status returned by call */
406 void *addr; /* resulting address */
407 unsigned long size; /* resulting size */
408 } map_view;
409 struct
411 enum apc_type type; /* APC_MAP_VIEW */
412 unsigned int status; /* status returned by call */
413 } unmap_view;
414 struct
416 enum apc_type type; /* APC_CREATE_THREAD */
417 unsigned int status; /* status returned by call */
418 thread_id_t tid; /* thread id */
419 obj_handle_t handle; /* handle to new thread */
420 } create_thread;
421 } apc_result_t;
423 /****************************************************************/
424 /* Request declarations */
426 /* Create a new process from the context of the parent */
427 @REQ(new_process)
428 int inherit_all; /* inherit all handles from parent */
429 unsigned int create_flags; /* creation flags */
430 int socket_fd; /* file descriptor for process socket */
431 obj_handle_t exe_file; /* file handle for main exe */
432 obj_handle_t hstdin; /* handle for stdin */
433 obj_handle_t hstdout; /* handle for stdout */
434 obj_handle_t hstderr; /* handle for stderr */
435 unsigned int process_access; /* access rights for process object */
436 unsigned int process_attr; /* attributes for process object */
437 unsigned int thread_access; /* access rights for thread object */
438 unsigned int thread_attr; /* attributes for thread object */
439 VARARG(info,startup_info); /* startup information */
440 VARARG(env,unicode_str); /* environment for new process */
441 @REPLY
442 obj_handle_t info; /* new process info handle */
443 process_id_t pid; /* process id */
444 obj_handle_t phandle; /* process handle (in the current process) */
445 thread_id_t tid; /* thread id */
446 obj_handle_t thandle; /* thread handle (in the current process) */
447 @END
450 /* Retrieve information about a newly started process */
451 @REQ(get_new_process_info)
452 obj_handle_t info; /* info handle returned from new_process_request */
453 @REPLY
454 int success; /* did the process start successfully? */
455 int exit_code; /* process exit code if failed */
456 @END
459 /* Create a new thread from the context of the parent */
460 @REQ(new_thread)
461 unsigned int access; /* wanted access rights */
462 unsigned int attributes; /* object attributes */
463 int suspend; /* new thread should be suspended on creation */
464 int request_fd; /* fd for request pipe */
465 @REPLY
466 thread_id_t tid; /* thread id */
467 obj_handle_t handle; /* thread handle (in the current process) */
468 @END
471 /* Retrieve the new process startup info */
472 @REQ(get_startup_info)
473 @REPLY
474 obj_handle_t exe_file; /* file handle for main exe */
475 obj_handle_t hstdin; /* handle for stdin */
476 obj_handle_t hstdout; /* handle for stdout */
477 obj_handle_t hstderr; /* handle for stderr */
478 VARARG(info,startup_info); /* startup information */
479 VARARG(env,unicode_str); /* environment */
480 @END
483 /* Signal the end of the process initialization */
484 @REQ(init_process_done)
485 void* module; /* main module base address */
486 void* entry; /* process entry point */
487 int gui; /* is it a GUI process? */
488 @END
491 /* Initialize a thread; called from the child after fork()/clone() */
492 @REQ(init_thread)
493 int unix_pid; /* Unix pid of new thread */
494 int unix_tid; /* Unix tid of new thread */
495 int debug_level; /* new debug level */
496 void* teb; /* TEB of new thread (in thread address space) */
497 void* peb; /* address of PEB (in thread address space) */
498 void* entry; /* thread entry point (in thread address space) */
499 void* ldt_copy; /* address of LDT copy (in thread address space) */
500 int reply_fd; /* fd for reply pipe */
501 int wait_fd; /* fd for blocking calls pipe */
502 @REPLY
503 process_id_t pid; /* process id of the new thread's process */
504 thread_id_t tid; /* thread id of the new thread */
505 data_size_t info_size; /* total size of startup info */
506 abs_time_t server_start; /* server start time */
507 int version; /* protocol version */
508 @END
511 /* Terminate a process */
512 @REQ(terminate_process)
513 obj_handle_t handle; /* process handle to terminate */
514 int exit_code; /* process exit code */
515 @REPLY
516 int self; /* suicide? */
517 @END
520 /* Terminate a thread */
521 @REQ(terminate_thread)
522 obj_handle_t handle; /* thread handle to terminate */
523 int exit_code; /* thread exit code */
524 @REPLY
525 int self; /* suicide? */
526 int last; /* last thread in this process? */
527 @END
530 /* Retrieve information about a process */
531 @REQ(get_process_info)
532 obj_handle_t handle; /* process handle */
533 @REPLY
534 process_id_t pid; /* server process id */
535 process_id_t ppid; /* server process id of parent */
536 int exit_code; /* process exit code */
537 int priority; /* priority class */
538 int affinity; /* process affinity mask */
539 void* peb; /* PEB address in process address space */
540 abs_time_t start_time; /* process start time */
541 abs_time_t end_time; /* process end time */
542 @END
545 /* Set a process informations */
546 @REQ(set_process_info)
547 obj_handle_t handle; /* process handle */
548 int mask; /* setting mask (see below) */
549 int priority; /* priority class */
550 int affinity; /* affinity mask */
551 @END
552 #define SET_PROCESS_INFO_PRIORITY 0x01
553 #define SET_PROCESS_INFO_AFFINITY 0x02
556 /* Retrieve information about a thread */
557 @REQ(get_thread_info)
558 obj_handle_t handle; /* thread handle */
559 thread_id_t tid_in; /* thread id (optional) */
560 @REPLY
561 process_id_t pid; /* server process id */
562 thread_id_t tid; /* server thread id */
563 void* teb; /* thread teb pointer */
564 int exit_code; /* thread exit code */
565 int priority; /* thread priority level */
566 int affinity; /* thread affinity mask */
567 abs_time_t creation_time; /* thread creation time */
568 abs_time_t exit_time; /* thread exit time */
569 int last; /* last thread in process */
570 @END
573 /* Set a thread informations */
574 @REQ(set_thread_info)
575 obj_handle_t handle; /* thread handle */
576 int mask; /* setting mask (see below) */
577 int priority; /* priority class */
578 int affinity; /* affinity mask */
579 obj_handle_t token; /* impersonation token */
580 @END
581 #define SET_THREAD_INFO_PRIORITY 0x01
582 #define SET_THREAD_INFO_AFFINITY 0x02
583 #define SET_THREAD_INFO_TOKEN 0x04
586 /* Retrieve information about a module */
587 @REQ(get_dll_info)
588 obj_handle_t handle; /* process handle */
589 void* base_address; /* base address of module */
590 @REPLY
591 size_t size; /* module size */
592 void* entry_point;
593 VARARG(filename,unicode_str); /* file name of module */
594 @END
597 /* Suspend a thread */
598 @REQ(suspend_thread)
599 obj_handle_t handle; /* thread handle */
600 @REPLY
601 int count; /* new suspend count */
602 @END
605 /* Resume a thread */
606 @REQ(resume_thread)
607 obj_handle_t handle; /* thread handle */
608 @REPLY
609 int count; /* new suspend count */
610 @END
613 /* Notify the server that a dll has been loaded */
614 @REQ(load_dll)
615 obj_handle_t handle; /* file handle */
616 void* base; /* base address */
617 size_t size; /* dll size */
618 int dbg_offset; /* debug info offset */
619 int dbg_size; /* debug info size */
620 void* name; /* ptr to ptr to name (in process addr space) */
621 VARARG(filename,unicode_str); /* file name of dll */
622 @END
625 /* Notify the server that a dll is being unloaded */
626 @REQ(unload_dll)
627 void* base; /* base address */
628 @END
631 /* Queue an APC for a thread or process */
632 @REQ(queue_apc)
633 obj_handle_t thread; /* thread handle */
634 obj_handle_t process; /* process handle */
635 apc_call_t call; /* call arguments */
636 @REPLY
637 obj_handle_t handle; /* APC handle */
638 int self; /* run APC in caller itself? */
639 @END
642 /* Get next APC to call */
643 @REQ(get_apc)
644 int alertable; /* is thread alertable? */
645 obj_handle_t prev; /* handle to previous APC */
646 apc_result_t result; /* result of previous APC */
647 @REPLY
648 obj_handle_t handle; /* handle to APC */
649 apc_call_t call; /* call arguments */
650 @END
653 /* Get the result of an APC call */
654 @REQ(get_apc_result)
655 obj_handle_t handle; /* handle to the APC */
656 @REPLY
657 apc_result_t result; /* result of the APC */
658 @END
661 /* Close a handle for the current process */
662 @REQ(close_handle)
663 obj_handle_t handle; /* handle to close */
664 @END
667 /* Set a handle information */
668 @REQ(set_handle_info)
669 obj_handle_t handle; /* handle we are interested in */
670 int flags; /* new handle flags */
671 int mask; /* mask for flags to set */
672 @REPLY
673 int old_flags; /* old flag value */
674 @END
677 /* Duplicate a handle */
678 @REQ(dup_handle)
679 obj_handle_t src_process; /* src process handle */
680 obj_handle_t src_handle; /* src handle to duplicate */
681 obj_handle_t dst_process; /* dst process handle */
682 unsigned int access; /* wanted access rights */
683 unsigned int attributes; /* object attributes */
684 unsigned int options; /* duplicate options (see below) */
685 @REPLY
686 obj_handle_t handle; /* duplicated handle in dst process */
687 int self; /* is the source the current process? */
688 int closed; /* whether the source handle has been closed */
689 @END
690 #define DUP_HANDLE_CLOSE_SOURCE DUPLICATE_CLOSE_SOURCE
691 #define DUP_HANDLE_SAME_ACCESS DUPLICATE_SAME_ACCESS
692 #define DUP_HANDLE_MAKE_GLOBAL 0x80000000 /* Not a Windows flag */
695 /* Open a handle to a process */
696 @REQ(open_process)
697 process_id_t pid; /* process id to open */
698 unsigned int access; /* wanted access rights */
699 unsigned int attributes; /* object attributes */
700 @REPLY
701 obj_handle_t handle; /* handle to the process */
702 @END
705 /* Open a handle to a thread */
706 @REQ(open_thread)
707 thread_id_t tid; /* thread id to open */
708 unsigned int access; /* wanted access rights */
709 unsigned int attributes; /* object attributes */
710 @REPLY
711 obj_handle_t handle; /* handle to the thread */
712 @END
715 /* Wait for handles */
716 @REQ(select)
717 int flags; /* wait flags (see below) */
718 void* cookie; /* magic cookie to return to client */
719 obj_handle_t signal; /* object to signal (0 if none) */
720 abs_time_t timeout; /* absolute timeout */
721 VARARG(handles,handles); /* handles to select on */
722 @END
723 #define SELECT_ALL 1
724 #define SELECT_ALERTABLE 2
725 #define SELECT_INTERRUPTIBLE 4
726 #define SELECT_TIMEOUT 8
729 /* Create an event */
730 @REQ(create_event)
731 unsigned int access; /* wanted access rights */
732 unsigned int attributes; /* object attributes */
733 obj_handle_t rootdir; /* root directory */
734 int manual_reset; /* manual reset event */
735 int initial_state; /* initial state of the event */
736 VARARG(name,unicode_str); /* object name */
737 @REPLY
738 obj_handle_t handle; /* handle to the event */
739 @END
741 /* Event operation */
742 @REQ(event_op)
743 obj_handle_t handle; /* handle to event */
744 int op; /* event operation (see below) */
745 @END
746 enum event_op { PULSE_EVENT, SET_EVENT, RESET_EVENT };
749 /* Open an event */
750 @REQ(open_event)
751 unsigned int access; /* wanted access rights */
752 unsigned int attributes; /* object attributes */
753 obj_handle_t rootdir; /* root directory */
754 VARARG(name,unicode_str); /* object name */
755 @REPLY
756 obj_handle_t handle; /* handle to the event */
757 @END
760 /* Create a mutex */
761 @REQ(create_mutex)
762 unsigned int access; /* wanted access rights */
763 unsigned int attributes; /* object attributes */
764 obj_handle_t rootdir; /* root directory */
765 int owned; /* initially owned? */
766 VARARG(name,unicode_str); /* object name */
767 @REPLY
768 obj_handle_t handle; /* handle to the mutex */
769 @END
772 /* Release a mutex */
773 @REQ(release_mutex)
774 obj_handle_t handle; /* handle to the mutex */
775 @REPLY
776 unsigned int prev_count; /* value of internal counter, before release */
777 @END
780 /* Open a mutex */
781 @REQ(open_mutex)
782 unsigned int access; /* wanted access rights */
783 unsigned int attributes; /* object attributes */
784 obj_handle_t rootdir; /* root directory */
785 VARARG(name,unicode_str); /* object name */
786 @REPLY
787 obj_handle_t handle; /* handle to the mutex */
788 @END
791 /* Create a semaphore */
792 @REQ(create_semaphore)
793 unsigned int access; /* wanted access rights */
794 unsigned int attributes; /* object attributes */
795 obj_handle_t rootdir; /* root directory */
796 unsigned int initial; /* initial count */
797 unsigned int max; /* maximum count */
798 VARARG(name,unicode_str); /* object name */
799 @REPLY
800 obj_handle_t handle; /* handle to the semaphore */
801 @END
804 /* Release a semaphore */
805 @REQ(release_semaphore)
806 obj_handle_t handle; /* handle to the semaphore */
807 unsigned int count; /* count to add to semaphore */
808 @REPLY
809 unsigned int prev_count; /* previous semaphore count */
810 @END
813 /* Open a semaphore */
814 @REQ(open_semaphore)
815 unsigned int access; /* wanted access rights */
816 unsigned int attributes; /* object attributes */
817 obj_handle_t rootdir; /* root directory */
818 VARARG(name,unicode_str); /* object name */
819 @REPLY
820 obj_handle_t handle; /* handle to the semaphore */
821 @END
824 /* Create a file */
825 @REQ(create_file)
826 unsigned int access; /* wanted access rights */
827 unsigned int attributes; /* object attributes */
828 unsigned int sharing; /* sharing flags */
829 int create; /* file create action */
830 unsigned int options; /* file options */
831 unsigned int attrs; /* file attributes for creation */
832 VARARG(filename,string); /* file name */
833 @REPLY
834 obj_handle_t handle; /* handle to the file */
835 @END
838 /* Open a file object */
839 @REQ(open_file_object)
840 unsigned int access; /* wanted access rights */
841 unsigned int attributes; /* open attributes */
842 obj_handle_t rootdir; /* root directory */
843 unsigned int sharing; /* sharing flags */
844 VARARG(filename,unicode_str); /* file name */
845 @REPLY
846 obj_handle_t handle; /* handle to the file */
847 @END
850 /* Allocate a file handle for a Unix fd */
851 @REQ(alloc_file_handle)
852 unsigned int access; /* wanted access rights */
853 unsigned int attributes; /* object attributes */
854 int fd; /* file descriptor on the client side */
855 @REPLY
856 obj_handle_t handle; /* handle to the file */
857 @END
860 /* Get a Unix fd to access a file */
861 @REQ(get_handle_fd)
862 obj_handle_t handle; /* handle to the file */
863 unsigned int access; /* wanted access rights */
864 int cached; /* is it cached on the client already? */
865 @REPLY
866 int type; /* file type (see below) */
867 int flags; /* file read/write flags (see below) */
868 @END
869 enum server_fd_type
871 FD_TYPE_INVALID, /* invalid file (no associated fd) */
872 FD_TYPE_FILE, /* regular file */
873 FD_TYPE_DIR, /* directory */
874 FD_TYPE_SOCKET, /* socket */
875 FD_TYPE_SERIAL, /* serial port */
876 FD_TYPE_PIPE, /* named pipe */
877 FD_TYPE_MAILSLOT, /* mailslot */
878 FD_TYPE_DEVICE, /* Windows device file */
879 FD_TYPE_NB_TYPES
881 #define FD_FLAG_OVERLAPPED 0x01 /* fd opened in overlapped mode */
882 #define FD_FLAG_TIMEOUT 0x02 /* read/write is synchronous */
883 #define FD_FLAG_RECV_SHUTDOWN 0x04
884 #define FD_FLAG_SEND_SHUTDOWN 0x08
885 #define FD_FLAG_AVAILABLE 0x10 /* in overlap read/write operation,
886 * only handle available data (don't wait) */
887 #define FD_FLAG_REMOVABLE 0x20 /* is it on a removable device? */
889 /* Flush a file buffers */
890 @REQ(flush_file)
891 obj_handle_t handle; /* handle to the file */
892 @REPLY
893 obj_handle_t event; /* event set when finished */
894 @END
897 /* Lock a region of a file */
898 @REQ(lock_file)
899 obj_handle_t handle; /* handle to the file */
900 unsigned int offset_low; /* offset of start of lock */
901 unsigned int offset_high; /* offset of start of lock */
902 unsigned int count_low; /* count of bytes to lock */
903 unsigned int count_high; /* count of bytes to lock */
904 int shared; /* shared or exclusive lock? */
905 int wait; /* do we want to wait? */
906 @REPLY
907 obj_handle_t handle; /* handle to wait on */
908 int overlapped; /* is it an overlapped I/O handle? */
909 @END
912 /* Unlock a region of a file */
913 @REQ(unlock_file)
914 obj_handle_t handle; /* handle to the file */
915 unsigned int offset_low; /* offset of start of unlock */
916 unsigned int offset_high; /* offset of start of unlock */
917 unsigned int count_low; /* count of bytes to unlock */
918 unsigned int count_high; /* count of bytes to unlock */
919 @END
922 /* Get ready to unmount a Unix device */
923 @REQ(unmount_device)
924 obj_handle_t handle; /* handle to a file on the device */
925 @END
928 /* Create a socket */
929 @REQ(create_socket)
930 unsigned int access; /* wanted access rights */
931 unsigned int attributes; /* object attributes */
932 int family; /* family, see socket manpage */
933 int type; /* type, see socket manpage */
934 int protocol; /* protocol, see socket manpage */
935 unsigned int flags; /* socket flags */
936 @REPLY
937 obj_handle_t handle; /* handle to the new socket */
938 @END
941 /* Accept a socket */
942 @REQ(accept_socket)
943 obj_handle_t lhandle; /* handle to the listening socket */
944 unsigned int access; /* wanted access rights */
945 unsigned int attributes; /* object attributes */
946 @REPLY
947 obj_handle_t handle; /* handle to the new socket */
948 @END
951 /* Set socket event parameters */
952 @REQ(set_socket_event)
953 obj_handle_t handle; /* handle to the socket */
954 unsigned int mask; /* event mask */
955 obj_handle_t event; /* event object */
956 user_handle_t window; /* window to send the message to */
957 unsigned int msg; /* message to send */
958 @END
961 /* Get socket event parameters */
962 @REQ(get_socket_event)
963 obj_handle_t handle; /* handle to the socket */
964 int service; /* clear pending? */
965 obj_handle_t c_event; /* event to clear */
966 @REPLY
967 unsigned int mask; /* event mask */
968 unsigned int pmask; /* pending events */
969 unsigned int state; /* status bits */
970 VARARG(errors,ints); /* event errors */
971 @END
974 /* Reenable pending socket events */
975 @REQ(enable_socket_event)
976 obj_handle_t handle; /* handle to the socket */
977 unsigned int mask; /* events to re-enable */
978 unsigned int sstate; /* status bits to set */
979 unsigned int cstate; /* status bits to clear */
980 @END
982 @REQ(set_socket_deferred)
983 obj_handle_t handle; /* handle to the socket */
984 obj_handle_t deferred; /* handle to the socket for which accept() is deferred */
985 @END
987 /* Allocate a console (only used by a console renderer) */
988 @REQ(alloc_console)
989 unsigned int access; /* wanted access rights */
990 unsigned int attributes; /* object attributes */
991 process_id_t pid; /* pid of process which shall be attached to the console */
992 @REPLY
993 obj_handle_t handle_in; /* handle to console input */
994 obj_handle_t event; /* handle to renderer events change notification */
995 @END
998 /* Free the console of the current process */
999 @REQ(free_console)
1000 @END
1003 #define CONSOLE_RENDERER_NONE_EVENT 0x00
1004 #define CONSOLE_RENDERER_TITLE_EVENT 0x01
1005 #define CONSOLE_RENDERER_ACTIVE_SB_EVENT 0x02
1006 #define CONSOLE_RENDERER_SB_RESIZE_EVENT 0x03
1007 #define CONSOLE_RENDERER_UPDATE_EVENT 0x04
1008 #define CONSOLE_RENDERER_CURSOR_POS_EVENT 0x05
1009 #define CONSOLE_RENDERER_CURSOR_GEOM_EVENT 0x06
1010 #define CONSOLE_RENDERER_DISPLAY_EVENT 0x07
1011 #define CONSOLE_RENDERER_EXIT_EVENT 0x08
1012 struct console_renderer_event
1014 short event;
1015 union
1017 struct update
1019 short top;
1020 short bottom;
1021 } update;
1022 struct resize
1024 short width;
1025 short height;
1026 } resize;
1027 struct cursor_pos
1029 short x;
1030 short y;
1031 } cursor_pos;
1032 struct cursor_geom
1034 short visible;
1035 short size;
1036 } cursor_geom;
1037 struct display
1039 short left;
1040 short top;
1041 short width;
1042 short height;
1043 } display;
1044 } u;
1047 /* retrieve console events for the renderer */
1048 @REQ(get_console_renderer_events)
1049 obj_handle_t handle; /* handle to console input events */
1050 @REPLY
1051 VARARG(data,bytes); /* the various console_renderer_events */
1052 @END
1055 /* Open a handle to the process console */
1056 @REQ(open_console)
1057 obj_handle_t from; /* 0 (resp 1) input (resp output) of current process console */
1058 /* otherwise console_in handle to get active screen buffer? */
1059 unsigned int access; /* wanted access rights */
1060 unsigned int attributes; /* object attributes */
1061 int share; /* share mask (only for output handles) */
1062 @REPLY
1063 obj_handle_t handle; /* handle to the console */
1064 @END
1067 /* Get the input queue wait event */
1068 @REQ(get_console_wait_event)
1069 @REPLY
1070 obj_handle_t handle;
1071 @END
1073 /* Get a console mode (input or output) */
1074 @REQ(get_console_mode)
1075 obj_handle_t handle; /* handle to the console */
1076 @REPLY
1077 int mode; /* console mode */
1078 @END
1081 /* Set a console mode (input or output) */
1082 @REQ(set_console_mode)
1083 obj_handle_t handle; /* handle to the console */
1084 int mode; /* console mode */
1085 @END
1088 /* Set info about a console (input only) */
1089 @REQ(set_console_input_info)
1090 obj_handle_t handle; /* handle to console input, or 0 for process' console */
1091 int mask; /* setting mask (see below) */
1092 obj_handle_t active_sb; /* active screen buffer */
1093 int history_mode; /* whether we duplicate lines in history */
1094 int history_size; /* number of lines in history */
1095 int edition_mode; /* index to the edition mode flavors */
1096 VARARG(title,unicode_str); /* console title */
1097 @END
1098 #define SET_CONSOLE_INPUT_INFO_ACTIVE_SB 0x01
1099 #define SET_CONSOLE_INPUT_INFO_TITLE 0x02
1100 #define SET_CONSOLE_INPUT_INFO_HISTORY_MODE 0x04
1101 #define SET_CONSOLE_INPUT_INFO_HISTORY_SIZE 0x08
1102 #define SET_CONSOLE_INPUT_INFO_EDITION_MODE 0x10
1105 /* Get info about a console (input only) */
1106 @REQ(get_console_input_info)
1107 obj_handle_t handle; /* handle to console input, or 0 for process' console */
1108 @REPLY
1109 int history_mode; /* whether we duplicate lines in history */
1110 int history_size; /* number of lines in history */
1111 int history_index; /* number of used lines in history */
1112 int edition_mode; /* index to the edition mode flavors */
1113 VARARG(title,unicode_str); /* console title */
1114 @END
1117 /* appends a string to console's history */
1118 @REQ(append_console_input_history)
1119 obj_handle_t handle; /* handle to console input, or 0 for process' console */
1120 VARARG(line,unicode_str); /* line to add */
1121 @END
1124 /* appends a string to console's history */
1125 @REQ(get_console_input_history)
1126 obj_handle_t handle; /* handle to console input, or 0 for process' console */
1127 int index; /* index to get line from */
1128 @REPLY
1129 int total; /* total length of line in Unicode chars */
1130 VARARG(line,unicode_str); /* line to add */
1131 @END
1134 /* creates a new screen buffer on process' console */
1135 @REQ(create_console_output)
1136 obj_handle_t handle_in; /* handle to console input, or 0 for process' console */
1137 unsigned int access; /* wanted access rights */
1138 unsigned int attributes; /* object attributes */
1139 unsigned int share; /* sharing credentials */
1140 @REPLY
1141 obj_handle_t handle_out; /* handle to the screen buffer */
1142 @END
1145 /* Set info about a console (output only) */
1146 @REQ(set_console_output_info)
1147 obj_handle_t handle; /* handle to the console */
1148 int mask; /* setting mask (see below) */
1149 short int cursor_size; /* size of cursor (percentage filled) */
1150 short int cursor_visible;/* cursor visibility flag */
1151 short int cursor_x; /* position of cursor (x, y) */
1152 short int cursor_y;
1153 short int width; /* width of the screen buffer */
1154 short int height; /* height of the screen buffer */
1155 short int attr; /* default attribute */
1156 short int win_left; /* window actually displayed by renderer */
1157 short int win_top; /* the rect area is expressed withing the */
1158 short int win_right; /* boundaries of the screen buffer */
1159 short int win_bottom;
1160 short int max_width; /* maximum size (width x height) for the window */
1161 short int max_height;
1162 @END
1163 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_GEOM 0x01
1164 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_POS 0x02
1165 #define SET_CONSOLE_OUTPUT_INFO_SIZE 0x04
1166 #define SET_CONSOLE_OUTPUT_INFO_ATTR 0x08
1167 #define SET_CONSOLE_OUTPUT_INFO_DISPLAY_WINDOW 0x10
1168 #define SET_CONSOLE_OUTPUT_INFO_MAX_SIZE 0x20
1171 /* Get info about a console (output only) */
1172 @REQ(get_console_output_info)
1173 obj_handle_t handle; /* handle to the console */
1174 @REPLY
1175 short int cursor_size; /* size of cursor (percentage filled) */
1176 short int cursor_visible;/* cursor visibility flag */
1177 short int cursor_x; /* position of cursor (x, y) */
1178 short int cursor_y;
1179 short int width; /* width of the screen buffer */
1180 short int height; /* height of the screen buffer */
1181 short int attr; /* default attribute */
1182 short int win_left; /* window actually displayed by renderer */
1183 short int win_top; /* the rect area is expressed withing the */
1184 short int win_right; /* boundaries of the screen buffer */
1185 short int win_bottom;
1186 short int max_width; /* maximum size (width x height) for the window */
1187 short int max_height;
1188 @END
1190 /* Add input records to a console input queue */
1191 @REQ(write_console_input)
1192 obj_handle_t handle; /* handle to the console input */
1193 VARARG(rec,input_records); /* input records */
1194 @REPLY
1195 int written; /* number of records written */
1196 @END
1199 /* Fetch input records from a console input queue */
1200 @REQ(read_console_input)
1201 obj_handle_t handle; /* handle to the console input */
1202 int flush; /* flush the retrieved records from the queue? */
1203 @REPLY
1204 int read; /* number of records read */
1205 VARARG(rec,input_records); /* input records */
1206 @END
1209 /* write data (chars and/or attributes) in a screen buffer */
1210 @REQ(write_console_output)
1211 obj_handle_t handle; /* handle to the console output */
1212 int x; /* position where to start writing */
1213 int y;
1214 int mode; /* char info (see below) */
1215 int wrap; /* wrap around at end of line? */
1216 VARARG(data,bytes); /* info to write */
1217 @REPLY
1218 int written; /* number of char infos actually written */
1219 int width; /* width of screen buffer */
1220 int height; /* height of screen buffer */
1221 @END
1222 enum char_info_mode
1224 CHAR_INFO_MODE_TEXT, /* characters only */
1225 CHAR_INFO_MODE_ATTR, /* attributes only */
1226 CHAR_INFO_MODE_TEXTATTR, /* both characters and attributes */
1227 CHAR_INFO_MODE_TEXTSTDATTR /* characters but use standard attributes */
1231 /* fill a screen buffer with constant data (chars and/or attributes) */
1232 @REQ(fill_console_output)
1233 obj_handle_t handle; /* handle to the console output */
1234 int x; /* position where to start writing */
1235 int y;
1236 int mode; /* char info mode */
1237 int count; /* number to write */
1238 int wrap; /* wrap around at end of line? */
1239 char_info_t data; /* data to write */
1240 @REPLY
1241 int written; /* number of char infos actually written */
1242 @END
1245 /* read data (chars and/or attributes) from a screen buffer */
1246 @REQ(read_console_output)
1247 obj_handle_t handle; /* handle to the console output */
1248 int x; /* position (x,y) where to start reading */
1249 int y;
1250 int mode; /* char info mode */
1251 int wrap; /* wrap around at end of line? */
1252 @REPLY
1253 int width; /* width of screen buffer */
1254 int height; /* height of screen buffer */
1255 VARARG(data,bytes);
1256 @END
1259 /* move a rect (of data) in screen buffer content */
1260 @REQ(move_console_output)
1261 obj_handle_t handle; /* handle to the console output */
1262 short int x_src; /* position (x, y) of rect to start moving from */
1263 short int y_src;
1264 short int x_dst; /* position (x, y) of rect to move to */
1265 short int y_dst;
1266 short int w; /* size of the rect (width, height) to move */
1267 short int h;
1268 @END
1271 /* Sends a signal to a process group */
1272 @REQ(send_console_signal)
1273 int signal; /* the signal to send */
1274 process_id_t group_id; /* the group to send the signal to */
1275 @END
1278 /* enable directory change notifications */
1279 @REQ(read_directory_changes)
1280 unsigned int filter; /* notification filter */
1281 obj_handle_t handle; /* handle to the directory */
1282 obj_handle_t event; /* handle to the event */
1283 int subtree; /* watch the subtree? */
1284 int want_data; /* flag indicating whether change data should be collected */
1285 void* io_apc; /* APC routine to queue upon end of async */
1286 void* io_sb; /* I/O status block (unique across all async on this handle) */
1287 void* io_user; /* data to pass back to caller */
1288 @END
1291 @REQ(read_change)
1292 obj_handle_t handle;
1293 @REPLY
1294 int action; /* type of change */
1295 VARARG(name,string); /* name of directory entry that changed */
1296 @END
1299 /* Create a file mapping */
1300 @REQ(create_mapping)
1301 unsigned int access; /* wanted access rights */
1302 unsigned int attributes; /* object attributes */
1303 obj_handle_t rootdir; /* root directory */
1304 int size_high; /* mapping size */
1305 int size_low; /* mapping size */
1306 int protect; /* protection flags (see below) */
1307 obj_handle_t file_handle; /* file handle */
1308 VARARG(name,unicode_str); /* object name */
1309 @REPLY
1310 obj_handle_t handle; /* handle to the mapping */
1311 @END
1312 /* protection flags */
1313 #define VPROT_READ 0x01
1314 #define VPROT_WRITE 0x02
1315 #define VPROT_EXEC 0x04
1316 #define VPROT_WRITECOPY 0x08
1317 #define VPROT_GUARD 0x10
1318 #define VPROT_NOCACHE 0x20
1319 #define VPROT_COMMITTED 0x40
1320 #define VPROT_IMAGE 0x80
1323 /* Open a mapping */
1324 @REQ(open_mapping)
1325 unsigned int access; /* wanted access rights */
1326 unsigned int attributes; /* object attributes */
1327 obj_handle_t rootdir; /* root directory */
1328 VARARG(name,unicode_str); /* object name */
1329 @REPLY
1330 obj_handle_t handle; /* handle to the mapping */
1331 @END
1334 /* Get information about a file mapping */
1335 @REQ(get_mapping_info)
1336 obj_handle_t handle; /* handle to the mapping */
1337 @REPLY
1338 int size_high; /* mapping size */
1339 int size_low; /* mapping size */
1340 int protect; /* protection flags */
1341 int header_size; /* header size (for VPROT_IMAGE mapping) */
1342 void* base; /* default base addr (for VPROT_IMAGE mapping) */
1343 obj_handle_t mapping; /* duplicate mapping handle unless removable */
1344 obj_handle_t shared_file; /* shared mapping file handle */
1345 int shared_size; /* shared mapping size */
1346 @END
1349 #define SNAP_HEAPLIST 0x00000001
1350 #define SNAP_PROCESS 0x00000002
1351 #define SNAP_THREAD 0x00000004
1352 #define SNAP_MODULE 0x00000008
1353 /* Create a snapshot */
1354 @REQ(create_snapshot)
1355 unsigned int attributes; /* object attributes */
1356 int flags; /* snapshot flags (SNAP_*) */
1357 process_id_t pid; /* process id */
1358 @REPLY
1359 obj_handle_t handle; /* handle to the snapshot */
1360 @END
1363 /* Get the next process from a snapshot */
1364 @REQ(next_process)
1365 obj_handle_t handle; /* handle to the snapshot */
1366 int reset; /* reset snapshot position? */
1367 @REPLY
1368 int count; /* process usage count */
1369 process_id_t pid; /* process id */
1370 process_id_t ppid; /* parent process id */
1371 void* heap; /* heap base */
1372 void* module; /* main module */
1373 int threads; /* number of threads */
1374 int priority; /* process priority */
1375 int handles; /* number of handles */
1376 VARARG(filename,unicode_str); /* file name of main exe */
1377 @END
1380 /* Get the next thread from a snapshot */
1381 @REQ(next_thread)
1382 obj_handle_t handle; /* handle to the snapshot */
1383 int reset; /* reset snapshot position? */
1384 @REPLY
1385 int count; /* thread usage count */
1386 process_id_t pid; /* process id */
1387 thread_id_t tid; /* thread id */
1388 int base_pri; /* base priority */
1389 int delta_pri; /* delta priority */
1390 @END
1393 /* Get the next module from a snapshot */
1394 @REQ(next_module)
1395 obj_handle_t handle; /* handle to the snapshot */
1396 int reset; /* reset snapshot position? */
1397 @REPLY
1398 process_id_t pid; /* process id */
1399 void* base; /* module base address */
1400 size_t size; /* module size */
1401 VARARG(filename,unicode_str); /* file name of module */
1402 @END
1405 /* Wait for a debug event */
1406 @REQ(wait_debug_event)
1407 int get_handle; /* should we alloc a handle for waiting? */
1408 @REPLY
1409 process_id_t pid; /* process id */
1410 thread_id_t tid; /* thread id */
1411 obj_handle_t wait; /* wait handle if no event ready */
1412 VARARG(event,debug_event); /* debug event data */
1413 @END
1416 /* Queue an exception event */
1417 @REQ(queue_exception_event)
1418 int first; /* first chance exception? */
1419 VARARG(record,exc_event); /* thread context followed by exception record */
1420 @REPLY
1421 obj_handle_t handle; /* handle to the queued event */
1422 @END
1425 /* Retrieve the status of an exception event */
1426 @REQ(get_exception_status)
1427 obj_handle_t handle; /* handle to the queued event */
1428 @REPLY
1429 VARARG(context,context); /* modified thread context */
1430 @END
1433 /* Send an output string to the debugger */
1434 @REQ(output_debug_string)
1435 void* string; /* string to display (in debugged process address space) */
1436 int unicode; /* is it Unicode? */
1437 int length; /* string length */
1438 @END
1441 /* Continue a debug event */
1442 @REQ(continue_debug_event)
1443 process_id_t pid; /* process id to continue */
1444 thread_id_t tid; /* thread id to continue */
1445 int status; /* continuation status */
1446 @END
1449 /* Start/stop debugging an existing process */
1450 @REQ(debug_process)
1451 process_id_t pid; /* id of the process to debug */
1452 int attach; /* 1=attaching / 0=detaching from the process */
1453 @END
1456 /* Simulate a breakpoint in a process */
1457 @REQ(debug_break)
1458 obj_handle_t handle; /* process handle */
1459 @REPLY
1460 int self; /* was it the caller itself? */
1461 @END
1464 /* Set debugger kill on exit flag */
1465 @REQ(set_debugger_kill_on_exit)
1466 int kill_on_exit; /* 0=detach/1=kill debuggee when debugger dies */
1467 @END
1470 /* Read data from a process address space */
1471 @REQ(read_process_memory)
1472 obj_handle_t handle; /* process handle */
1473 void* addr; /* addr to read from */
1474 @REPLY
1475 VARARG(data,bytes); /* result data */
1476 @END
1479 /* Write data to a process address space */
1480 @REQ(write_process_memory)
1481 obj_handle_t handle; /* process handle */
1482 void* addr; /* addr to write to */
1483 VARARG(data,bytes); /* data to write */
1484 @END
1487 /* Create a registry key */
1488 @REQ(create_key)
1489 obj_handle_t parent; /* handle to the parent key */
1490 unsigned int access; /* desired access rights */
1491 unsigned int attributes; /* object attributes */
1492 unsigned int options; /* creation options */
1493 time_t modif; /* last modification time */
1494 data_size_t namelen; /* length of key name in bytes */
1495 VARARG(name,unicode_str,namelen); /* key name */
1496 VARARG(class,unicode_str); /* class name */
1497 @REPLY
1498 obj_handle_t hkey; /* handle to the created key */
1499 int created; /* has it been newly created? */
1500 @END
1502 /* Open a registry key */
1503 @REQ(open_key)
1504 obj_handle_t parent; /* handle to the parent key */
1505 unsigned int access; /* desired access rights */
1506 unsigned int attributes; /* object attributes */
1507 VARARG(name,unicode_str); /* key name */
1508 @REPLY
1509 obj_handle_t hkey; /* handle to the open key */
1510 @END
1513 /* Delete a registry key */
1514 @REQ(delete_key)
1515 obj_handle_t hkey; /* handle to the key */
1516 @END
1519 /* Flush a registry key */
1520 @REQ(flush_key)
1521 obj_handle_t hkey; /* handle to the key */
1522 @END
1525 /* Enumerate registry subkeys */
1526 @REQ(enum_key)
1527 obj_handle_t hkey; /* handle to registry key */
1528 int index; /* index of subkey (or -1 for current key) */
1529 int info_class; /* requested information class */
1530 @REPLY
1531 int subkeys; /* number of subkeys */
1532 int max_subkey; /* longest subkey name */
1533 int max_class; /* longest class name */
1534 int values; /* number of values */
1535 int max_value; /* longest value name */
1536 int max_data; /* longest value data */
1537 time_t modif; /* last modification time */
1538 data_size_t total; /* total length needed for full name and class */
1539 data_size_t namelen; /* length of key name in bytes */
1540 VARARG(name,unicode_str,namelen); /* key name */
1541 VARARG(class,unicode_str); /* class name */
1542 @END
1545 /* Set a value of a registry key */
1546 @REQ(set_key_value)
1547 obj_handle_t hkey; /* handle to registry key */
1548 int type; /* value type */
1549 data_size_t namelen; /* length of value name in bytes */
1550 VARARG(name,unicode_str,namelen); /* value name */
1551 VARARG(data,bytes); /* value data */
1552 @END
1555 /* Retrieve the value of a registry key */
1556 @REQ(get_key_value)
1557 obj_handle_t hkey; /* handle to registry key */
1558 VARARG(name,unicode_str); /* value name */
1559 @REPLY
1560 int type; /* value type */
1561 data_size_t total; /* total length needed for data */
1562 VARARG(data,bytes); /* value data */
1563 @END
1566 /* Enumerate a value of a registry key */
1567 @REQ(enum_key_value)
1568 obj_handle_t hkey; /* handle to registry key */
1569 int index; /* value index */
1570 int info_class; /* requested information class */
1571 @REPLY
1572 int type; /* value type */
1573 data_size_t total; /* total length needed for full name and data */
1574 data_size_t namelen; /* length of value name in bytes */
1575 VARARG(name,unicode_str,namelen); /* value name */
1576 VARARG(data,bytes); /* value data */
1577 @END
1580 /* Delete a value of a registry key */
1581 @REQ(delete_key_value)
1582 obj_handle_t hkey; /* handle to registry key */
1583 VARARG(name,unicode_str); /* value name */
1584 @END
1587 /* Load a registry branch from a file */
1588 @REQ(load_registry)
1589 obj_handle_t hkey; /* root key to load to */
1590 obj_handle_t file; /* file to load from */
1591 VARARG(name,unicode_str); /* subkey name */
1592 @END
1595 /* UnLoad a registry branch from a file */
1596 @REQ(unload_registry)
1597 obj_handle_t hkey; /* root key to unload to */
1598 @END
1601 /* Save a registry branch to a file */
1602 @REQ(save_registry)
1603 obj_handle_t hkey; /* key to save */
1604 obj_handle_t file; /* file to save to */
1605 @END
1608 /* Add a registry key change notification */
1609 @REQ(set_registry_notification)
1610 obj_handle_t hkey; /* key to watch for changes */
1611 obj_handle_t event; /* event to set */
1612 int subtree; /* should we watch the whole subtree? */
1613 unsigned int filter; /* things to watch */
1614 @END
1617 /* Create a waitable timer */
1618 @REQ(create_timer)
1619 unsigned int access; /* wanted access rights */
1620 unsigned int attributes; /* object attributes */
1621 obj_handle_t rootdir; /* root directory */
1622 int manual; /* manual reset */
1623 VARARG(name,unicode_str); /* object name */
1624 @REPLY
1625 obj_handle_t handle; /* handle to the timer */
1626 @END
1629 /* Open a waitable timer */
1630 @REQ(open_timer)
1631 unsigned int access; /* wanted access rights */
1632 unsigned int attributes; /* object attributes */
1633 obj_handle_t rootdir; /* root directory */
1634 VARARG(name,unicode_str); /* object name */
1635 @REPLY
1636 obj_handle_t handle; /* handle to the timer */
1637 @END
1639 /* Set a waitable timer */
1640 @REQ(set_timer)
1641 obj_handle_t handle; /* handle to the timer */
1642 abs_time_t expire; /* next expiration absolute time */
1643 int period; /* timer period in ms */
1644 void* callback; /* callback function */
1645 void* arg; /* callback argument */
1646 @REPLY
1647 int signaled; /* was the timer signaled before this call ? */
1648 @END
1650 /* Cancel a waitable timer */
1651 @REQ(cancel_timer)
1652 obj_handle_t handle; /* handle to the timer */
1653 @REPLY
1654 int signaled; /* was the timer signaled before this calltime ? */
1655 @END
1657 /* Get information on a waitable timer */
1658 @REQ(get_timer_info)
1659 obj_handle_t handle; /* handle to the timer */
1660 @REPLY
1661 abs_time_t when; /* absolute time when the timer next expires */
1662 int signaled; /* is the timer signaled? */
1663 @END
1666 /* Retrieve the current context of a thread */
1667 @REQ(get_thread_context)
1668 obj_handle_t handle; /* thread handle */
1669 unsigned int flags; /* context flags */
1670 int suspend; /* if getting context during suspend */
1671 @REPLY
1672 int self; /* was it a handle to the current thread? */
1673 VARARG(context,context); /* thread context */
1674 @END
1677 /* Set the current context of a thread */
1678 @REQ(set_thread_context)
1679 obj_handle_t handle; /* thread handle */
1680 unsigned int flags; /* context flags */
1681 int suspend; /* if setting context during suspend */
1682 VARARG(context,context); /* thread context */
1683 @REPLY
1684 int self; /* was it a handle to the current thread? */
1685 @END
1688 /* Fetch a selector entry for a thread */
1689 @REQ(get_selector_entry)
1690 obj_handle_t handle; /* thread handle */
1691 int entry; /* LDT entry */
1692 @REPLY
1693 unsigned int base; /* selector base */
1694 unsigned int limit; /* selector limit */
1695 unsigned char flags; /* selector flags */
1696 @END
1699 /* Add an atom */
1700 @REQ(add_atom)
1701 obj_handle_t table; /* which table to add atom to */
1702 VARARG(name,unicode_str); /* atom name */
1703 @REPLY
1704 atom_t atom; /* resulting atom */
1705 @END
1708 /* Delete an atom */
1709 @REQ(delete_atom)
1710 obj_handle_t table; /* which table to delete atom from */
1711 atom_t atom; /* atom handle */
1712 @END
1715 /* Find an atom */
1716 @REQ(find_atom)
1717 obj_handle_t table; /* which table to find atom from */
1718 VARARG(name,unicode_str); /* atom name */
1719 @REPLY
1720 atom_t atom; /* atom handle */
1721 @END
1724 /* Get information about an atom */
1725 @REQ(get_atom_information)
1726 obj_handle_t table; /* which table to find atom from */
1727 atom_t atom; /* atom handle */
1728 @REPLY
1729 int count; /* atom lock count */
1730 int pinned; /* whether the atom has been pinned */
1731 data_size_t total; /* actual length of atom name */
1732 VARARG(name,unicode_str); /* atom name */
1733 @END
1736 /* Set information about an atom */
1737 @REQ(set_atom_information)
1738 obj_handle_t table; /* which table to find atom from */
1739 atom_t atom; /* atom handle */
1740 int pinned; /* whether to bump atom information */
1741 @END
1744 /* Empty an atom table */
1745 @REQ(empty_atom_table)
1746 obj_handle_t table; /* which table to find atom from */
1747 int if_pinned; /* whether to delete pinned atoms */
1748 @END
1751 /* Init an atom table */
1752 @REQ(init_atom_table)
1753 int entries; /* number of entries (only for local) */
1754 @REPLY
1755 obj_handle_t table; /* handle to the atom table */
1756 @END
1759 /* Get the message queue of the current thread */
1760 @REQ(get_msg_queue)
1761 @REPLY
1762 obj_handle_t handle; /* handle to the queue */
1763 @END
1766 /* Set the current message queue wakeup mask */
1767 @REQ(set_queue_mask)
1768 unsigned int wake_mask; /* wakeup bits mask */
1769 unsigned int changed_mask; /* changed bits mask */
1770 int skip_wait; /* will we skip waiting if signaled? */
1771 @REPLY
1772 unsigned int wake_bits; /* current wake bits */
1773 unsigned int changed_bits; /* current changed bits */
1774 @END
1777 /* Get the current message queue status */
1778 @REQ(get_queue_status)
1779 int clear; /* should we clear the change bits? */
1780 @REPLY
1781 unsigned int wake_bits; /* wake bits */
1782 unsigned int changed_bits; /* changed bits since last time */
1783 @END
1786 /* Retrieve the process idle event */
1787 @REQ(get_process_idle_event)
1788 obj_handle_t handle; /* process handle */
1789 @REPLY
1790 obj_handle_t event; /* handle to idle event */
1791 @END
1794 /* Send a message to a thread queue */
1795 @REQ(send_message)
1796 thread_id_t id; /* thread id */
1797 int type; /* message type (see below) */
1798 int flags; /* message flags (see below) */
1799 user_handle_t win; /* window handle */
1800 unsigned int msg; /* message code */
1801 unsigned long wparam; /* parameters */
1802 unsigned long lparam; /* parameters */
1803 int timeout; /* timeout for reply */
1804 VARARG(data,message_data); /* message data for sent messages */
1805 @END
1807 @REQ(post_quit_message)
1808 int exit_code; /* exit code to return */
1809 @END
1811 enum message_type
1813 MSG_ASCII, /* Ascii message (from SendMessageA) */
1814 MSG_UNICODE, /* Unicode message (from SendMessageW) */
1815 MSG_NOTIFY, /* notify message (from SendNotifyMessageW), always Unicode */
1816 MSG_CALLBACK, /* callback message (from SendMessageCallbackW), always Unicode */
1817 MSG_CALLBACK_RESULT,/* result of a callback message */
1818 MSG_OTHER_PROCESS, /* sent from other process, may include vararg data, always Unicode */
1819 MSG_POSTED, /* posted message (from PostMessageW), always Unicode */
1820 MSG_HARDWARE, /* hardware message */
1821 MSG_WINEVENT /* winevent message */
1823 #define SEND_MSG_ABORT_IF_HUNG 0x01
1826 /* Send a hardware message to a thread queue */
1827 @REQ(send_hardware_message)
1828 thread_id_t id; /* thread id */
1829 user_handle_t win; /* window handle */
1830 unsigned int msg; /* message code */
1831 unsigned int time; /* message time */
1832 unsigned long wparam; /* parameters */
1833 unsigned long lparam; /* parameters */
1834 unsigned long info; /* extra info */
1835 int x; /* x position */
1836 int y; /* y position */
1837 @END
1840 /* Get a message from the current queue */
1841 @REQ(get_message)
1842 int flags; /* see below */
1843 user_handle_t get_win; /* window handle to get */
1844 unsigned int get_first; /* first message code to get */
1845 unsigned int get_last; /* last message code to get */
1846 unsigned int hw_id; /* id of the previous hardware message (or 0) */
1847 @REPLY
1848 user_handle_t win; /* window handle */
1849 int type; /* message type */
1850 unsigned int msg; /* message code */
1851 unsigned long wparam; /* parameters */
1852 unsigned long lparam; /* parameters */
1853 unsigned long info; /* extra info */
1854 int x; /* x position */
1855 int y; /* y position */
1856 unsigned int time; /* message time */
1857 unsigned int hw_id; /* id if hardware message */
1858 unsigned int active_hooks; /* active hooks bitmap */
1859 data_size_t total; /* total size of extra data */
1860 VARARG(data,message_data); /* message data for sent messages */
1861 @END
1862 #define GET_MSG_REMOVE 1 /* remove the message */
1863 #define GET_MSG_SENT_ONLY 2 /* only get sent messages */
1865 /* Reply to a sent message */
1866 @REQ(reply_message)
1867 unsigned int result; /* message result */
1868 int remove; /* should we remove the message? */
1869 VARARG(data,bytes); /* message data for sent messages */
1870 @END
1873 /* Accept the current hardware message */
1874 @REQ(accept_hardware_message)
1875 unsigned int hw_id; /* id of the hardware message */
1876 int remove; /* should we remove the message? */
1877 user_handle_t new_win; /* new destination window for current message */
1878 @END
1881 /* Retrieve the reply for the last message sent */
1882 @REQ(get_message_reply)
1883 int cancel; /* cancel message if not ready? */
1884 @REPLY
1885 unsigned int result; /* message result */
1886 VARARG(data,bytes); /* message data for sent messages */
1887 @END
1890 /* Set a window timer */
1891 @REQ(set_win_timer)
1892 user_handle_t win; /* window handle */
1893 unsigned int msg; /* message to post */
1894 unsigned int rate; /* timer rate in ms */
1895 unsigned long id; /* timer id */
1896 unsigned long lparam; /* message lparam (callback proc) */
1897 @REPLY
1898 unsigned long id; /* timer id */
1899 @END
1902 /* Kill a window timer */
1903 @REQ(kill_win_timer)
1904 user_handle_t win; /* window handle */
1905 unsigned int msg; /* message to post */
1906 unsigned long id; /* timer id */
1907 @END
1910 /* Retrieve info about a serial port */
1911 @REQ(get_serial_info)
1912 obj_handle_t handle; /* handle to comm port */
1913 @REPLY
1914 unsigned int readinterval;
1915 unsigned int readconst;
1916 unsigned int readmult;
1917 unsigned int writeconst;
1918 unsigned int writemult;
1919 unsigned int eventmask;
1920 @END
1923 /* Set info about a serial port */
1924 @REQ(set_serial_info)
1925 obj_handle_t handle; /* handle to comm port */
1926 int flags; /* bitmask to set values (see below) */
1927 unsigned int readinterval;
1928 unsigned int readconst;
1929 unsigned int readmult;
1930 unsigned int writeconst;
1931 unsigned int writemult;
1932 unsigned int eventmask;
1933 @END
1934 #define SERIALINFO_SET_TIMEOUTS 0x01
1935 #define SERIALINFO_SET_MASK 0x02
1938 /* Create an async I/O */
1939 @REQ(register_async)
1940 obj_handle_t handle; /* handle to comm port, socket or file */
1941 int type; /* type of queue to look after */
1942 void* io_apc; /* APC routine to queue upon end of async */
1943 void* io_sb; /* I/O status block (unique across all async on this handle) */
1944 void* io_user; /* data to pass back to caller */
1945 int count; /* count - usually # of bytes to be read/written */
1946 @END
1947 #define ASYNC_TYPE_READ 0x01
1948 #define ASYNC_TYPE_WRITE 0x02
1949 #define ASYNC_TYPE_WAIT 0x03
1952 /* Cancel all async op on a fd */
1953 @REQ(cancel_async)
1954 obj_handle_t handle; /* handle to comm port, socket or file */
1955 @END
1958 /* Create a named pipe */
1959 @REQ(create_named_pipe)
1960 unsigned int access;
1961 unsigned int attributes; /* object attributes */
1962 obj_handle_t rootdir; /* root directory */
1963 unsigned int options;
1964 unsigned int flags;
1965 unsigned int maxinstances;
1966 unsigned int outsize;
1967 unsigned int insize;
1968 unsigned int timeout;
1969 VARARG(name,unicode_str); /* pipe name */
1970 @REPLY
1971 obj_handle_t handle; /* handle to the pipe */
1972 @END
1974 /* flags in create_named_pipe and get_named_pipe_info */
1975 #define NAMED_PIPE_MESSAGE_STREAM_WRITE 0x0001
1976 #define NAMED_PIPE_MESSAGE_STREAM_READ 0x0002
1977 #define NAMED_PIPE_NONBLOCKING_MODE 0x0004
1978 #define NAMED_PIPE_SERVER_END 0x8000
1980 /* Open an existing named pipe */
1981 @REQ(open_named_pipe)
1982 unsigned int access;
1983 unsigned int attributes; /* object attributes */
1984 obj_handle_t rootdir; /* root directory */
1985 unsigned int flags; /* file flags */
1986 VARARG(name,unicode_str); /* pipe name */
1987 @REPLY
1988 obj_handle_t handle; /* handle to the pipe */
1989 @END
1992 /* Connect to a named pipe */
1993 @REQ(connect_named_pipe)
1994 obj_handle_t handle;
1995 obj_handle_t event;
1996 void* func;
1997 @END
2000 /* Wait for a named pipe */
2001 @REQ(wait_named_pipe)
2002 obj_handle_t handle;
2003 unsigned int timeout;
2004 obj_handle_t event;
2005 void* func;
2006 VARARG(name,unicode_str); /* pipe name */
2007 @END
2010 /* Disconnect a named pipe */
2011 @REQ(disconnect_named_pipe)
2012 obj_handle_t handle;
2013 @END
2016 @REQ(get_named_pipe_info)
2017 obj_handle_t handle;
2018 @REPLY
2019 unsigned int flags;
2020 unsigned int maxinstances;
2021 unsigned int instances;
2022 unsigned int outsize;
2023 unsigned int insize;
2024 @END
2027 /* Create a window */
2028 @REQ(create_window)
2029 user_handle_t parent; /* parent window */
2030 user_handle_t owner; /* owner window */
2031 atom_t atom; /* class atom */
2032 void* instance; /* module instance */
2033 @REPLY
2034 user_handle_t handle; /* created window */
2035 user_handle_t parent; /* full handle of parent */
2036 user_handle_t owner; /* full handle of owner */
2037 int extra; /* number of extra bytes */
2038 void* class_ptr; /* pointer to class in client address space */
2039 @END
2042 /* Destroy a window */
2043 @REQ(destroy_window)
2044 user_handle_t handle; /* handle to the window */
2045 @END
2048 /* Retrieve the desktop window for the current thread */
2049 @REQ(get_desktop_window)
2050 int force; /* force creation if it doesn't exist */
2051 @REPLY
2052 user_handle_t handle; /* handle to the desktop window */
2053 @END
2056 /* Set a window owner */
2057 @REQ(set_window_owner)
2058 user_handle_t handle; /* handle to the window */
2059 user_handle_t owner; /* new owner */
2060 @REPLY
2061 user_handle_t full_owner; /* full handle of new owner */
2062 user_handle_t prev_owner; /* full handle of previous owner */
2063 @END
2066 /* Get information from a window handle */
2067 @REQ(get_window_info)
2068 user_handle_t handle; /* handle to the window */
2069 @REPLY
2070 user_handle_t full_handle; /* full 32-bit handle */
2071 user_handle_t last_active; /* last active popup */
2072 process_id_t pid; /* process owning the window */
2073 thread_id_t tid; /* thread owning the window */
2074 atom_t atom; /* class atom */
2075 int is_unicode; /* ANSI or unicode */
2076 @END
2079 /* Set some information in a window */
2080 @REQ(set_window_info)
2081 unsigned int flags; /* flags for fields to set (see below) */
2082 user_handle_t handle; /* handle to the window */
2083 unsigned int style; /* window style */
2084 unsigned int ex_style; /* window extended style */
2085 unsigned int id; /* window id */
2086 int is_unicode; /* ANSI or unicode */
2087 void* instance; /* creator instance */
2088 unsigned long user_data; /* user-specific data */
2089 int extra_offset; /* offset to set in extra bytes */
2090 data_size_t extra_size; /* size to set in extra bytes */
2091 unsigned long extra_value; /* value to set in extra bytes */
2092 @REPLY
2093 unsigned int old_style; /* old window style */
2094 unsigned int old_ex_style; /* old window extended style */
2095 unsigned int old_id; /* old window id */
2096 void* old_instance; /* old creator instance */
2097 unsigned long old_user_data; /* old user-specific data */
2098 unsigned long old_extra_value; /* old value in extra bytes */
2099 @END
2100 #define SET_WIN_STYLE 0x01
2101 #define SET_WIN_EXSTYLE 0x02
2102 #define SET_WIN_ID 0x04
2103 #define SET_WIN_INSTANCE 0x08
2104 #define SET_WIN_USERDATA 0x10
2105 #define SET_WIN_EXTRA 0x20
2106 #define SET_WIN_UNICODE 0x40
2109 /* Set the parent of a window */
2110 @REQ(set_parent)
2111 user_handle_t handle; /* handle to the window */
2112 user_handle_t parent; /* handle to the parent */
2113 @REPLY
2114 user_handle_t old_parent; /* old parent window */
2115 user_handle_t full_parent; /* full handle of new parent */
2116 @END
2119 /* Get a list of the window parents, up to the root of the tree */
2120 @REQ(get_window_parents)
2121 user_handle_t handle; /* handle to the window */
2122 @REPLY
2123 int count; /* total count of parents */
2124 VARARG(parents,user_handles); /* parent handles */
2125 @END
2128 /* Get a list of the window children */
2129 @REQ(get_window_children)
2130 user_handle_t parent; /* parent window */
2131 atom_t atom; /* class atom for the listed children */
2132 thread_id_t tid; /* thread owning the listed children */
2133 @REPLY
2134 int count; /* total count of children */
2135 VARARG(children,user_handles); /* children handles */
2136 @END
2139 /* Get a list of the window children that contain a given point */
2140 @REQ(get_window_children_from_point)
2141 user_handle_t parent; /* parent window */
2142 int x; /* point in parent coordinates */
2143 int y;
2144 @REPLY
2145 int count; /* total count of children */
2146 VARARG(children,user_handles); /* children handles */
2147 @END
2150 /* Get window tree information from a window handle */
2151 @REQ(get_window_tree)
2152 user_handle_t handle; /* handle to the window */
2153 @REPLY
2154 user_handle_t parent; /* parent window */
2155 user_handle_t owner; /* owner window */
2156 user_handle_t next_sibling; /* next sibling in Z-order */
2157 user_handle_t prev_sibling; /* prev sibling in Z-order */
2158 user_handle_t first_sibling; /* first sibling in Z-order */
2159 user_handle_t last_sibling; /* last sibling in Z-order */
2160 user_handle_t first_child; /* first child */
2161 user_handle_t last_child; /* last child */
2162 @END
2164 /* Set the position and Z order of a window */
2165 @REQ(set_window_pos)
2166 unsigned int flags; /* SWP_* flags */
2167 user_handle_t handle; /* handle to the window */
2168 user_handle_t previous; /* previous window in Z order */
2169 rectangle_t window; /* window rectangle */
2170 rectangle_t client; /* client rectangle */
2171 VARARG(valid,rectangles); /* valid rectangles from WM_NCCALCSIZE */
2172 @REPLY
2173 unsigned int new_style; /* new window style */
2174 @END
2177 /* Get the window and client rectangles of a window */
2178 @REQ(get_window_rectangles)
2179 user_handle_t handle; /* handle to the window */
2180 @REPLY
2181 rectangle_t window; /* window rectangle */
2182 rectangle_t visible; /* visible part of the window rectangle */
2183 rectangle_t client; /* client rectangle */
2184 @END
2187 /* Get the window text */
2188 @REQ(get_window_text)
2189 user_handle_t handle; /* handle to the window */
2190 @REPLY
2191 VARARG(text,unicode_str); /* window text */
2192 @END
2195 /* Set the window text */
2196 @REQ(set_window_text)
2197 user_handle_t handle; /* handle to the window */
2198 VARARG(text,unicode_str); /* window text */
2199 @END
2202 /* Get the coordinates offset between two windows */
2203 @REQ(get_windows_offset)
2204 user_handle_t from; /* handle to the first window */
2205 user_handle_t to; /* handle to the second window */
2206 @REPLY
2207 int x; /* x coordinate offset */
2208 int y; /* y coordinate offset */
2209 @END
2212 /* Get the visible region of a window */
2213 @REQ(get_visible_region)
2214 user_handle_t window; /* handle to the window */
2215 unsigned int flags; /* DCX flags */
2216 @REPLY
2217 user_handle_t top_win; /* top window to clip against */
2218 rectangle_t top_rect; /* top window visible rect with screen coords */
2219 rectangle_t win_rect; /* window rect in screen coords */
2220 data_size_t total_size; /* total size of the resulting region */
2221 VARARG(region,rectangles); /* list of rectangles for the region (in screen coords) */
2222 @END
2225 /* Get the window region */
2226 @REQ(get_window_region)
2227 user_handle_t window; /* handle to the window */
2228 @REPLY
2229 data_size_t total_size; /* total size of the resulting region */
2230 VARARG(region,rectangles); /* list of rectangles for the region */
2231 @END
2234 /* Set the window region */
2235 @REQ(set_window_region)
2236 user_handle_t window; /* handle to the window */
2237 VARARG(region,rectangles); /* list of rectangles for the region */
2238 @END
2241 /* Get the window update region */
2242 @REQ(get_update_region)
2243 user_handle_t window; /* handle to the window */
2244 user_handle_t from_child; /* child to start searching from */
2245 unsigned int flags; /* update flags (see below) */
2246 @REPLY
2247 user_handle_t child; /* child to repaint (or window itself) */
2248 unsigned int flags; /* resulting update flags (see below) */
2249 data_size_t total_size; /* total size of the resulting region */
2250 VARARG(region,rectangles); /* list of rectangles for the region */
2251 @END
2252 #define UPDATE_NONCLIENT 0x01 /* get region for repainting non-client area */
2253 #define UPDATE_ERASE 0x02 /* get region for erasing client area */
2254 #define UPDATE_PAINT 0x04 /* get region for painting client area */
2255 #define UPDATE_INTERNALPAINT 0x08 /* get region if internal paint is pending */
2256 #define UPDATE_ALLCHILDREN 0x10 /* force repaint of all children */
2257 #define UPDATE_NOCHILDREN 0x20 /* don't try to repaint any children */
2258 #define UPDATE_NOREGION 0x40 /* don't return a region, only the flags */
2261 /* Update the z order of a window so that a given rectangle is fully visible */
2262 @REQ(update_window_zorder)
2263 user_handle_t window; /* handle to the window */
2264 rectangle_t rect; /* rectangle that must be visible */
2265 @END
2268 /* Mark parts of a window as needing a redraw */
2269 @REQ(redraw_window)
2270 user_handle_t window; /* handle to the window */
2271 unsigned int flags; /* RDW_* flags */
2272 VARARG(region,rectangles); /* list of rectangles for the region */
2273 @END
2276 /* Set a window property */
2277 @REQ(set_window_property)
2278 user_handle_t window; /* handle to the window */
2279 atom_t atom; /* property atom (if no name specified) */
2280 obj_handle_t handle; /* handle to store */
2281 VARARG(name,unicode_str); /* property name */
2282 @END
2285 /* Remove a window property */
2286 @REQ(remove_window_property)
2287 user_handle_t window; /* handle to the window */
2288 atom_t atom; /* property atom (if no name specified) */
2289 VARARG(name,unicode_str); /* property name */
2290 @REPLY
2291 obj_handle_t handle; /* handle stored in property */
2292 @END
2295 /* Get a window property */
2296 @REQ(get_window_property)
2297 user_handle_t window; /* handle to the window */
2298 atom_t atom; /* property atom (if no name specified) */
2299 VARARG(name,unicode_str); /* property name */
2300 @REPLY
2301 obj_handle_t handle; /* handle stored in property */
2302 @END
2305 /* Get the list of properties of a window */
2306 @REQ(get_window_properties)
2307 user_handle_t window; /* handle to the window */
2308 @REPLY
2309 int total; /* total number of properties */
2310 VARARG(props,properties); /* list of properties */
2311 @END
2314 /* Create a window station */
2315 @REQ(create_winstation)
2316 unsigned int flags; /* window station flags */
2317 unsigned int access; /* wanted access rights */
2318 unsigned int attributes; /* object attributes */
2319 VARARG(name,unicode_str); /* object name */
2320 @REPLY
2321 obj_handle_t handle; /* handle to the window station */
2322 @END
2325 /* Open a handle to a window station */
2326 @REQ(open_winstation)
2327 unsigned int access; /* wanted access rights */
2328 unsigned int attributes; /* object attributes */
2329 VARARG(name,unicode_str); /* object name */
2330 @REPLY
2331 obj_handle_t handle; /* handle to the window station */
2332 @END
2335 /* Close a window station */
2336 @REQ(close_winstation)
2337 obj_handle_t handle; /* handle to the window station */
2338 @END
2341 /* Get the process current window station */
2342 @REQ(get_process_winstation)
2343 @REPLY
2344 obj_handle_t handle; /* handle to the window station */
2345 @END
2348 /* Set the process current window station */
2349 @REQ(set_process_winstation)
2350 obj_handle_t handle; /* handle to the window station */
2351 @END
2354 /* Create a desktop */
2355 @REQ(create_desktop)
2356 unsigned int flags; /* desktop flags */
2357 unsigned int access; /* wanted access rights */
2358 unsigned int attributes; /* object attributes */
2359 VARARG(name,unicode_str); /* object name */
2360 @REPLY
2361 obj_handle_t handle; /* handle to the desktop */
2362 @END
2365 /* Open a handle to a desktop */
2366 @REQ(open_desktop)
2367 unsigned int flags; /* desktop flags */
2368 unsigned int access; /* wanted access rights */
2369 unsigned int attributes; /* object attributes */
2370 VARARG(name,unicode_str); /* object name */
2371 @REPLY
2372 obj_handle_t handle; /* handle to the desktop */
2373 @END
2376 /* Close a desktop */
2377 @REQ(close_desktop)
2378 obj_handle_t handle; /* handle to the desktop */
2379 @END
2382 /* Get the thread current desktop */
2383 @REQ(get_thread_desktop)
2384 thread_id_t tid; /* thread id */
2385 @REPLY
2386 obj_handle_t handle; /* handle to the desktop */
2387 @END
2390 /* Set the thread current desktop */
2391 @REQ(set_thread_desktop)
2392 obj_handle_t handle; /* handle to the desktop */
2393 @END
2396 /* Get/set information about a user object (window station or desktop) */
2397 @REQ(set_user_object_info)
2398 obj_handle_t handle; /* handle to the object */
2399 unsigned int flags; /* information to set */
2400 unsigned int obj_flags; /* new object flags */
2401 @REPLY
2402 int is_desktop; /* is object a desktop? */
2403 unsigned int old_obj_flags; /* old object flags */
2404 VARARG(name,unicode_str); /* object name */
2405 @END
2406 #define SET_USER_OBJECT_FLAGS 1
2409 /* Attach (or detach) thread inputs */
2410 @REQ(attach_thread_input)
2411 thread_id_t tid_from; /* thread to be attached */
2412 thread_id_t tid_to; /* thread to which tid_from should be attached */
2413 int attach; /* is it an attach? */
2414 @END
2417 /* Get input data for a given thread */
2418 @REQ(get_thread_input)
2419 thread_id_t tid; /* id of thread */
2420 @REPLY
2421 user_handle_t focus; /* handle to the focus window */
2422 user_handle_t capture; /* handle to the capture window */
2423 user_handle_t active; /* handle to the active window */
2424 user_handle_t foreground; /* handle to the global foreground window */
2425 user_handle_t menu_owner; /* handle to the menu owner */
2426 user_handle_t move_size; /* handle to the moving/resizing window */
2427 user_handle_t caret; /* handle to the caret window */
2428 rectangle_t rect; /* caret rectangle */
2429 @END
2432 /* Get the time of the last input event */
2433 @REQ(get_last_input_time)
2434 @REPLY
2435 unsigned int time;
2436 @END
2439 /* Retrieve queue keyboard state for a given thread */
2440 @REQ(get_key_state)
2441 thread_id_t tid; /* id of thread */
2442 int key; /* optional key code or -1 */
2443 @REPLY
2444 unsigned char state; /* state of specified key */
2445 VARARG(keystate,bytes); /* state array for all the keys */
2446 @END
2448 /* Set queue keyboard state for a given thread */
2449 @REQ(set_key_state)
2450 thread_id_t tid; /* id of thread */
2451 VARARG(keystate,bytes); /* state array for all the keys */
2452 @END
2454 /* Set the system foreground window */
2455 @REQ(set_foreground_window)
2456 user_handle_t handle; /* handle to the foreground window */
2457 @REPLY
2458 user_handle_t previous; /* handle to the previous foreground window */
2459 int send_msg_old; /* whether we have to send a msg to the old window */
2460 int send_msg_new; /* whether we have to send a msg to the new window */
2461 @END
2463 /* Set the current thread focus window */
2464 @REQ(set_focus_window)
2465 user_handle_t handle; /* handle to the focus window */
2466 @REPLY
2467 user_handle_t previous; /* handle to the previous focus window */
2468 @END
2470 /* Set the current thread active window */
2471 @REQ(set_active_window)
2472 user_handle_t handle; /* handle to the active window */
2473 @REPLY
2474 user_handle_t previous; /* handle to the previous active window */
2475 @END
2477 /* Set the current thread capture window */
2478 @REQ(set_capture_window)
2479 user_handle_t handle; /* handle to the capture window */
2480 unsigned int flags; /* capture flags (see below) */
2481 @REPLY
2482 user_handle_t previous; /* handle to the previous capture window */
2483 user_handle_t full_handle; /* full 32-bit handle of new capture window */
2484 @END
2485 #define CAPTURE_MENU 0x01 /* capture is for a menu */
2486 #define CAPTURE_MOVESIZE 0x02 /* capture is for moving/resizing */
2489 /* Set the current thread caret window */
2490 @REQ(set_caret_window)
2491 user_handle_t handle; /* handle to the caret window */
2492 int width; /* caret width */
2493 int height; /* caret height */
2494 @REPLY
2495 user_handle_t previous; /* handle to the previous caret window */
2496 rectangle_t old_rect; /* previous caret rectangle */
2497 int old_hide; /* previous hide count */
2498 int old_state; /* previous caret state (1=on, 0=off) */
2499 @END
2502 /* Set the current thread caret information */
2503 @REQ(set_caret_info)
2504 unsigned int flags; /* caret flags (see below) */
2505 user_handle_t handle; /* handle to the caret window */
2506 int x; /* caret x position */
2507 int y; /* caret y position */
2508 int hide; /* increment for hide count (can be negative to show it) */
2509 int state; /* caret state (1=on, 0=off, -1=toggle current state) */
2510 @REPLY
2511 user_handle_t full_handle; /* handle to the current caret window */
2512 rectangle_t old_rect; /* previous caret rectangle */
2513 int old_hide; /* previous hide count */
2514 int old_state; /* previous caret state (1=on, 0=off) */
2515 @END
2516 #define SET_CARET_POS 0x01 /* set the caret position from x,y */
2517 #define SET_CARET_HIDE 0x02 /* increment the caret hide count */
2518 #define SET_CARET_STATE 0x04 /* set the caret on/off state */
2521 /* Set a window hook */
2522 @REQ(set_hook)
2523 int id; /* id of the hook */
2524 process_id_t pid; /* id of process to set the hook into */
2525 thread_id_t tid; /* id of thread to set the hook into */
2526 int event_min;
2527 int event_max;
2528 int flags;
2529 void* proc; /* hook procedure */
2530 int unicode; /* is it a unicode hook? */
2531 VARARG(module,unicode_str); /* module name */
2532 @REPLY
2533 user_handle_t handle; /* handle to the hook */
2534 unsigned int active_hooks; /* active hooks bitmap */
2535 @END
2538 /* Remove a window hook */
2539 @REQ(remove_hook)
2540 user_handle_t handle; /* handle to the hook */
2541 int id; /* id of the hook if handle is 0 */
2542 void* proc; /* hook procedure if handle is 0 */
2543 @REPLY
2544 unsigned int active_hooks; /* active hooks bitmap */
2545 @END
2548 /* Start calling a hook chain */
2549 @REQ(start_hook_chain)
2550 int id; /* id of the hook */
2551 int event; /* signalled event */
2552 user_handle_t window; /* handle to the event window */
2553 int object_id; /* object id for out of context winevent */
2554 int child_id; /* child id for out of context winevent */
2555 @REPLY
2556 user_handle_t handle; /* handle to the next hook */
2557 process_id_t pid; /* process id for low-level keyboard/mouse hooks */
2558 thread_id_t tid; /* thread id for low-level keyboard/mouse hooks */
2559 void* proc; /* hook procedure */
2560 int unicode; /* is it a unicode hook? */
2561 unsigned int active_hooks; /* active hooks bitmap */
2562 VARARG(module,unicode_str); /* module name */
2563 @END
2566 /* Finished calling a hook chain */
2567 @REQ(finish_hook_chain)
2568 int id; /* id of the hook */
2569 @END
2572 /* Get the hook information */
2573 @REQ(get_hook_info)
2574 user_handle_t handle; /* handle to the current hook */
2575 int get_next; /* do we want info about current or next hook? */
2576 int event; /* signalled event */
2577 user_handle_t window; /* handle to the event window */
2578 int object_id; /* object id for out of context winevent */
2579 int child_id; /* child id for out of context winevent */
2580 @REPLY
2581 user_handle_t handle; /* handle to the hook */
2582 int id; /* id of the hook */
2583 process_id_t pid; /* process id for low-level keyboard/mouse hooks */
2584 thread_id_t tid; /* thread id for low-level keyboard/mouse hooks */
2585 void* proc; /* hook procedure */
2586 int unicode; /* is it a unicode hook? */
2587 VARARG(module,unicode_str); /* module name */
2588 @END
2591 /* Create a window class */
2592 @REQ(create_class)
2593 int local; /* is it a local class? */
2594 atom_t atom; /* class atom */
2595 unsigned int style; /* class style */
2596 void* instance; /* module instance */
2597 int extra; /* number of extra class bytes */
2598 int win_extra; /* number of window extra bytes */
2599 void* client_ptr; /* pointer to class in client address space */
2600 @END
2603 /* Destroy a window class */
2604 @REQ(destroy_class)
2605 atom_t atom; /* class atom */
2606 void* instance; /* module instance */
2607 @REPLY
2608 void* client_ptr; /* pointer to class in client address space */
2609 @END
2612 /* Set some information in a class */
2613 @REQ(set_class_info)
2614 user_handle_t window; /* handle to the window */
2615 unsigned int flags; /* flags for info to set (see below) */
2616 atom_t atom; /* class atom */
2617 unsigned int style; /* class style */
2618 int win_extra; /* number of window extra bytes */
2619 void* instance; /* module instance */
2620 int extra_offset; /* offset to set in extra bytes */
2621 data_size_t extra_size; /* size to set in extra bytes */
2622 unsigned long extra_value; /* value to set in extra bytes */
2623 @REPLY
2624 atom_t old_atom; /* previous class atom */
2625 unsigned int old_style; /* previous class style */
2626 int old_extra; /* previous number of class extra bytes */
2627 int old_win_extra; /* previous number of window extra bytes */
2628 void* old_instance; /* previous module instance */
2629 unsigned long old_extra_value; /* old value in extra bytes */
2630 @END
2631 #define SET_CLASS_ATOM 0x0001
2632 #define SET_CLASS_STYLE 0x0002
2633 #define SET_CLASS_WINEXTRA 0x0004
2634 #define SET_CLASS_INSTANCE 0x0008
2635 #define SET_CLASS_EXTRA 0x0010
2638 /* Set/get clipboard information */
2639 @REQ(set_clipboard_info)
2640 unsigned int flags; /* flags for fields to set (see below) */
2641 user_handle_t clipboard; /* clipboard window */
2642 user_handle_t owner; /* clipboard owner */
2643 user_handle_t viewer; /* first clipboard viewer */
2644 unsigned int seqno; /* change sequence number */
2645 @REPLY
2646 unsigned int flags; /* status flags (see below) */
2647 user_handle_t old_clipboard; /* old clipboard window */
2648 user_handle_t old_owner; /* old clipboard owner */
2649 user_handle_t old_viewer; /* old clipboard viewer */
2650 unsigned int seqno; /* current sequence number */
2651 @END
2653 #define SET_CB_OPEN 0x001
2654 #define SET_CB_OWNER 0x002
2655 #define SET_CB_VIEWER 0x004
2656 #define SET_CB_SEQNO 0x008
2657 #define SET_CB_RELOWNER 0x010
2658 #define SET_CB_CLOSE 0x020
2659 #define CB_OPEN 0x040
2660 #define CB_OWNER 0x080
2661 #define CB_PROCESS 0x100
2664 /* Open a security token */
2665 @REQ(open_token)
2666 obj_handle_t handle; /* handle to the thread or process */
2667 unsigned int access; /* access rights to the new token */
2668 unsigned int attributes;/* object attributes */
2669 unsigned int flags; /* flags (see below) */
2670 @REPLY
2671 obj_handle_t token; /* handle to the token */
2672 @END
2673 #define OPEN_TOKEN_THREAD 1
2674 #define OPEN_TOKEN_AS_SELF 2
2677 /* Set/get the global windows */
2678 @REQ(set_global_windows)
2679 unsigned int flags; /* flags for fields to set (see below) */
2680 user_handle_t shell_window; /* handle to the new shell window */
2681 user_handle_t shell_listview; /* handle to the new shell listview window */
2682 user_handle_t progman_window; /* handle to the new program manager window */
2683 user_handle_t taskman_window; /* handle to the new task manager window */
2684 @REPLY
2685 user_handle_t old_shell_window; /* handle to the shell window */
2686 user_handle_t old_shell_listview; /* handle to the shell listview window */
2687 user_handle_t old_progman_window; /* handle to the new program manager window */
2688 user_handle_t old_taskman_window; /* handle to the new task manager window */
2689 @END
2690 #define SET_GLOBAL_SHELL_WINDOWS 0x01 /* set both main shell and listview windows */
2691 #define SET_GLOBAL_PROGMAN_WINDOW 0x02
2692 #define SET_GLOBAL_TASKMAN_WINDOW 0x04
2694 /* Adjust the privileges held by a token */
2695 @REQ(adjust_token_privileges)
2696 obj_handle_t handle; /* handle to the token */
2697 int disable_all; /* disable all privileges? */
2698 int get_modified_state; /* get modified privileges? */
2699 VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to enable/disable/remove */
2700 @REPLY
2701 unsigned int len; /* total length in bytes required to store token privileges */
2702 VARARG(privileges,LUID_AND_ATTRIBUTES); /* modified privileges */
2703 @END
2705 /* Retrieves the set of privileges held by or available to a token */
2706 @REQ(get_token_privileges)
2707 obj_handle_t handle; /* handle to the token */
2708 @REPLY
2709 unsigned int len; /* total length in bytes required to store token privileges */
2710 VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
2711 @END
2713 /* Check the token has the required privileges */
2714 @REQ(check_token_privileges)
2715 obj_handle_t handle; /* handle to the token */
2716 int all_required; /* are all the privileges required for the check to succeed? */
2717 VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to check */
2718 @REPLY
2719 int has_privileges; /* does the token have the required privileges? */
2720 VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
2721 @END
2723 @REQ(duplicate_token)
2724 obj_handle_t handle; /* handle to the token to duplicate */
2725 unsigned int access; /* access rights to the new token */
2726 unsigned int attributes; /* object attributes */
2727 int primary; /* is the new token to be a primary one? */
2728 int impersonation_level; /* impersonation level of the new token */
2729 @REPLY
2730 obj_handle_t new_handle; /* duplicated handle */
2731 @END
2733 @REQ(access_check)
2734 obj_handle_t handle; /* handle to the token */
2735 unsigned int desired_access; /* desired access to the object */
2736 unsigned int mapping_read; /* mapping from generic read to specific rights */
2737 unsigned int mapping_write; /* mapping from generic write to specific rights */
2738 unsigned int mapping_execute; /* mapping from generic execute to specific rights */
2739 unsigned int mapping_all; /* mapping from generic all to specific rights */
2740 VARARG(sd,security_descriptor); /* security descriptor to check */
2741 @REPLY
2742 unsigned int access_granted; /* access rights actually granted */
2743 unsigned int access_status; /* was access granted? */
2744 unsigned int privileges_len; /* length needed to store privileges */
2745 VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges used during access check */
2746 @END
2748 @REQ(get_token_user)
2749 obj_handle_t handle; /* handle to the token */
2750 @REPLY
2751 data_size_t user_len; /* length needed to store user */
2752 VARARG(user,SID); /* sid of the user the token represents */
2753 @END
2755 @REQ(get_token_groups)
2756 obj_handle_t handle; /* handle to the token */
2757 @REPLY
2758 data_size_t user_len; /* length needed to store user */
2759 VARARG(user,token_groups); /* groups the token's user belongs to */
2760 @END
2762 @REQ(set_security_object)
2763 obj_handle_t handle; /* handle to the object */
2764 unsigned int security_info; /* which parts of security descriptor to set */
2765 VARARG(sd,security_descriptor); /* security descriptor to set */
2766 @END
2768 /* Create a mailslot */
2769 @REQ(create_mailslot)
2770 unsigned int access; /* wanted access rights */
2771 unsigned int attributes; /* object attributes */
2772 obj_handle_t rootdir; /* root directory */
2773 unsigned int max_msgsize;
2774 int read_timeout;
2775 VARARG(name,unicode_str); /* mailslot name */
2776 @REPLY
2777 obj_handle_t handle; /* handle to the mailslot */
2778 @END
2781 /* Open an existing mailslot */
2782 @REQ(open_mailslot)
2783 unsigned int access;
2784 unsigned int attributes; /* object attributes */
2785 obj_handle_t rootdir; /* root directory */
2786 unsigned int sharing; /* sharing mode */
2787 VARARG(name,unicode_str); /* mailslot name */
2788 @REPLY
2789 obj_handle_t handle; /* handle to the mailslot */
2790 @END
2793 /* Set mailslot information */
2794 @REQ(set_mailslot_info)
2795 obj_handle_t handle; /* handle to the mailslot */
2796 unsigned int flags;
2797 int read_timeout;
2798 @REPLY
2799 unsigned int max_msgsize;
2800 int read_timeout;
2801 @END
2802 #define MAILSLOT_SET_READ_TIMEOUT 1
2805 /* Create a directory object */
2806 @REQ(create_directory)
2807 unsigned int access; /* access flags */
2808 unsigned int attributes; /* object attributes */
2809 obj_handle_t rootdir; /* root directory */
2810 VARARG(directory_name,unicode_str); /* Directory name */
2811 @REPLY
2812 obj_handle_t handle; /* handle to the directory */
2813 @END
2816 /* Open a directory object */
2817 @REQ(open_directory)
2818 unsigned int access; /* access flags */
2819 unsigned int attributes; /* object attributes */
2820 obj_handle_t rootdir; /* root directory */
2821 VARARG(directory_name,unicode_str); /* Directory name */
2822 @REPLY
2823 obj_handle_t handle; /* handle to the directory */
2824 @END
2827 /* Create a symbolic link object */
2828 @REQ(create_symlink)
2829 unsigned int access; /* access flags */
2830 unsigned int attributes; /* object attributes */
2831 obj_handle_t rootdir; /* root directory */
2832 data_size_t name_len; /* length of the symlink name in bytes */
2833 VARARG(name,unicode_str,name_len); /* symlink name */
2834 VARARG(target_name,unicode_str); /* target name */
2835 @REPLY
2836 obj_handle_t handle; /* handle to the symlink */
2837 @END
2840 /* Open a symbolic link object */
2841 @REQ(open_symlink)
2842 unsigned int access; /* access flags */
2843 unsigned int attributes; /* object attributes */
2844 obj_handle_t rootdir; /* root directory */
2845 VARARG(name,unicode_str); /* symlink name */
2846 @REPLY
2847 obj_handle_t handle; /* handle to the symlink */
2848 @END
2851 /* Query a symbolic link object */
2852 @REQ(query_symlink)
2853 obj_handle_t handle; /* handle to the symlink */
2854 @REPLY
2855 VARARG(target_name,unicode_str); /* target name */
2856 @END
2859 /* Query basic object information */
2860 @REQ(get_object_info)
2861 obj_handle_t handle; /* handle to the object */
2862 @REPLY
2863 unsigned int access; /* granted access mask */
2864 unsigned int ref_count; /* object ref count */
2865 @END