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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25 @HEADER /* start of C declarations */
36 int req; /* request code */
37 size_t request_size; /* request variable part size */
38 size_t reply_size; /* reply variable part maximum size */
43 unsigned int error; /* error result */
44 size_t reply_size; /* reply variable part size */
47 /* placeholder structure for the maximum allowed request size */
48 /* this is used to construct the generic_request union */
49 struct request_max_size
51 int pad[16]; /* the max request size is 16 ints */
54 typedef void *obj_handle_t;
55 typedef void *user_handle_t;
56 typedef unsigned short atom_t;
57 typedef unsigned int process_id_t;
58 typedef unsigned int thread_id_t;
60 #define FIRST_USER_HANDLE 0x0020 /* first possible value for low word of user handle */
61 #define LAST_USER_HANDLE 0xffef /* last possible value for low word of user handle */
64 /* definitions of the event data depending on the event code */
65 struct debug_event_exception
67 EXCEPTION_RECORD record; /* exception record */
68 int first; /* first chance exception? */
70 struct debug_event_create_thread
72 obj_handle_t handle; /* handle to the new thread */
73 void *teb; /* thread teb (in debugged process address space) */
74 void *start; /* thread startup routine */
76 struct debug_event_create_process
78 obj_handle_t file; /* handle to the process exe file */
79 obj_handle_t process; /* handle to the new process */
80 obj_handle_t thread; /* handle to the new thread */
81 void *base; /* base of executable image */
82 int dbg_offset; /* offset of debug info in file */
83 int dbg_size; /* size of debug info */
84 void *teb; /* thread teb (in debugged process address space) */
85 void *start; /* thread startup routine */
86 void *name; /* image name (optional) */
87 int unicode; /* is it Unicode? */
89 struct debug_event_exit
91 int exit_code; /* thread or process exit code */
93 struct debug_event_load_dll
95 obj_handle_t handle; /* file handle for the dll */
96 void *base; /* base address of the dll */
97 int dbg_offset; /* offset of debug info in file */
98 int dbg_size; /* size of debug info */
99 void *name; /* image name (optional) */
100 int unicode; /* is it Unicode? */
102 struct debug_event_unload_dll
104 void *base; /* base address of the dll */
106 struct debug_event_output_string
108 void *string; /* string to display (in debugged process address space) */
109 int unicode; /* is it Unicode? */
110 int length; /* string length */
112 struct debug_event_rip_info
117 union debug_event_data
119 struct debug_event_exception exception;
120 struct debug_event_create_thread create_thread;
121 struct debug_event_create_process create_process;
122 struct debug_event_exit exit;
123 struct debug_event_load_dll load_dll;
124 struct debug_event_unload_dll unload_dll;
125 struct debug_event_output_string output_string;
126 struct debug_event_rip_info rip_info;
129 /* debug event data */
132 int code; /* event code */
133 union debug_event_data info; /* event information */
136 /* structure used in sending an fd from client to server */
139 thread_id_t tid; /* thread id */
140 int fd; /* file descriptor on client-side */
143 /* structure sent by the server on the wait fifo */
146 void *cookie; /* magic cookie that was passed in select_request */
147 int signaled; /* wait result */
150 /* structure for absolute timeouts */
153 int sec; /* seconds since Unix epoch */
154 int usec; /* microseconds */
157 /* structure returned in the list of window properties */
160 atom_t atom; /* property atom */
161 short string; /* was atom a string originally? */
162 obj_handle_t handle; /* handle stored in property */
165 /* structure to specify window rectangles */
174 /* structure for console char/attribute info */
181 /****************************************************************/
182 /* Request declarations */
184 /* Create a new process from the context of the parent */
186 int inherit_all; /* inherit all handles from parent */
187 int create_flags; /* creation flags */
188 int unix_pid; /* Unix pid of new process */
189 obj_handle_t exe_file; /* file handle for main exe */
190 obj_handle_t hstdin; /* handle for stdin */
191 obj_handle_t hstdout; /* handle for stdout */
192 obj_handle_t hstderr; /* handle for stderr */
193 VARARG(info,startup_info); /* startup information */
194 VARARG(env,unicode_str); /* environment for new process */
196 obj_handle_t info; /* new process info handle */
200 /* Retrieve information about a newly started process */
201 @REQ(get_new_process_info)
202 obj_handle_t info; /* info handle returned from new_process_request */
203 int pinherit; /* process handle inherit flag */
204 int tinherit; /* thread handle inherit flag */
206 process_id_t pid; /* process id */
207 obj_handle_t phandle; /* process handle (in the current process) */
208 thread_id_t tid; /* thread id */
209 obj_handle_t thandle; /* thread handle (in the current process) */
210 int success; /* did the process start successfully? */
214 /* Create a new thread from the context of the parent */
216 int suspend; /* new thread should be suspended on creation */
217 int inherit; /* inherit flag */
218 int request_fd; /* fd for request pipe */
220 thread_id_t tid; /* thread id */
221 obj_handle_t handle; /* thread handle (in the current process) */
225 /* Signal that we are finished booting on the client side */
227 int debug_level; /* new debug level */
231 /* Initialize a process; called from the new process context */
233 void* peb; /* addr of PEB */
234 void* ldt_copy; /* addr of LDT copy */
236 int create_flags; /* creation flags */
237 unsigned int server_start; /* server start time (GetTickCount) */
238 size_t info_size; /* total size of startup info */
239 obj_handle_t exe_file; /* file handle for main exe */
240 obj_handle_t hstdin; /* handle for stdin */
241 obj_handle_t hstdout; /* handle for stdout */
242 obj_handle_t hstderr; /* handle for stderr */
246 /* Retrieve the new process startup info */
247 @REQ(get_startup_info)
249 VARARG(info,startup_info); /* startup information */
250 VARARG(env,unicode_str); /* environment */
254 /* Signal the end of the process initialization */
255 @REQ(init_process_done)
256 void* module; /* main module base address */
257 size_t module_size; /* main module size */
258 void* entry; /* process entry point */
259 void* name; /* ptr to ptr to name (in process addr space) */
260 obj_handle_t exe_file; /* file handle for main exe */
261 int gui; /* is it a GUI process? */
262 VARARG(filename,unicode_str); /* file name of main exe */
266 /* Initialize a thread; called from the child after fork()/clone() */
268 int unix_pid; /* Unix pid of new thread */
269 int unix_tid; /* Unix tid of new thread */
270 void* teb; /* TEB of new thread (in thread address space) */
271 void* entry; /* thread entry point (in thread address space) */
272 int reply_fd; /* fd for reply pipe */
273 int wait_fd; /* fd for blocking calls pipe */
275 process_id_t pid; /* process id of the new thread's process */
276 thread_id_t tid; /* thread id of the new thread */
277 int boot; /* is this the boot thread? */
278 int version; /* protocol version */
282 /* Terminate a process */
283 @REQ(terminate_process)
284 obj_handle_t handle; /* process handle to terminate */
285 int exit_code; /* process exit code */
287 int self; /* suicide? */
291 /* Terminate a thread */
292 @REQ(terminate_thread)
293 obj_handle_t handle; /* thread handle to terminate */
294 int exit_code; /* thread exit code */
296 int self; /* suicide? */
297 int last; /* last thread in this process? */
301 /* Retrieve information about a process */
302 @REQ(get_process_info)
303 obj_handle_t handle; /* process handle */
305 process_id_t pid; /* server process id */
306 process_id_t ppid; /* server process id of parent */
307 int exit_code; /* process exit code */
308 int priority; /* priority class */
309 int process_affinity; /* process affinity mask */
310 int system_affinity; /* system affinity mask */
311 void* peb; /* PEB address in process address space */
315 /* Set a process informations */
316 @REQ(set_process_info)
317 obj_handle_t handle; /* process handle */
318 int mask; /* setting mask (see below) */
319 int priority; /* priority class */
320 int affinity; /* affinity mask */
322 #define SET_PROCESS_INFO_PRIORITY 0x01
323 #define SET_PROCESS_INFO_AFFINITY 0x02
326 /* Retrieve information about a thread */
327 @REQ(get_thread_info)
328 obj_handle_t handle; /* thread handle */
329 thread_id_t tid_in; /* thread id (optional) */
331 process_id_t pid; /* server process id */
332 thread_id_t tid; /* server thread id */
333 void* teb; /* thread teb pointer */
334 int exit_code; /* thread exit code */
335 int priority; /* thread priority level */
336 int affinity; /* thread affinity mask */
337 time_t creation_time; /* thread creation time */
338 time_t exit_time; /* thread exit time */
342 /* Set a thread informations */
343 @REQ(set_thread_info)
344 obj_handle_t handle; /* thread handle */
345 int mask; /* setting mask (see below) */
346 int priority; /* priority class */
347 int affinity; /* affinity mask */
349 #define SET_THREAD_INFO_PRIORITY 0x01
350 #define SET_THREAD_INFO_AFFINITY 0x02
353 /* Retrieve information about a module */
355 obj_handle_t handle; /* process handle */
356 void* base_address; /* base address of module */
358 size_t size; /* module size */
360 VARARG(filename,unicode_str); /* file name of module */
364 /* Suspend a thread */
366 obj_handle_t handle; /* thread handle */
368 int count; /* new suspend count */
372 /* Resume a thread */
374 obj_handle_t handle; /* thread handle */
376 int count; /* new suspend count */
380 /* Notify the server that a dll has been loaded */
382 obj_handle_t handle; /* file handle */
383 void* base; /* base address */
384 size_t size; /* dll size */
385 int dbg_offset; /* debug info offset */
386 int dbg_size; /* debug info size */
387 void* name; /* ptr to ptr to name (in process addr space) */
388 VARARG(filename,unicode_str); /* file name of dll */
392 /* Notify the server that a dll is being unloaded */
394 void* base; /* base address */
398 /* Queue an APC for a thread */
400 obj_handle_t handle; /* thread handle */
401 int user; /* user or system apc? */
402 void* func; /* function to call */
403 void* arg1; /* params for function to call */
409 /* Get next APC to call */
411 int alertable; /* is thread alertable? */
413 void* func; /* function to call */
414 int type; /* function type */
415 void* arg1; /* function arguments */
419 enum apc_type { APC_NONE, APC_USER, APC_TIMER, APC_ASYNC, APC_ASYNC_IO };
422 /* Close a handle for the current process */
424 obj_handle_t handle; /* handle to close */
426 int fd; /* associated fd to close */
430 /* Set a handle information */
431 @REQ(set_handle_info)
432 obj_handle_t handle; /* handle we are interested in */
433 int flags; /* new handle flags */
434 int mask; /* mask for flags to set */
435 int fd; /* file descriptor or -1 */
437 int old_flags; /* old flag value */
438 int cur_fd; /* current file descriptor */
442 /* Duplicate a handle */
444 obj_handle_t src_process; /* src process handle */
445 obj_handle_t src_handle; /* src handle to duplicate */
446 obj_handle_t dst_process; /* dst process handle */
447 unsigned int access; /* wanted access rights */
448 int inherit; /* inherit flag */
449 int options; /* duplicate options (see below) */
451 obj_handle_t handle; /* duplicated handle in dst process */
452 int fd; /* associated fd to close */
454 #define DUP_HANDLE_CLOSE_SOURCE DUPLICATE_CLOSE_SOURCE
455 #define DUP_HANDLE_SAME_ACCESS DUPLICATE_SAME_ACCESS
456 #define DUP_HANDLE_MAKE_GLOBAL 0x80000000 /* Not a Windows flag */
459 /* Open a handle to a process */
461 process_id_t pid; /* process id to open */
462 unsigned int access; /* wanted access rights */
463 int inherit; /* inherit flag */
465 obj_handle_t handle; /* handle to the process */
469 /* Open a handle to a thread */
471 thread_id_t tid; /* thread id to open */
472 unsigned int access; /* wanted access rights */
473 int inherit; /* inherit flag */
475 obj_handle_t handle; /* handle to the thread */
479 /* Wait for handles */
481 int flags; /* wait flags (see below) */
482 void* cookie; /* magic cookie to return to client */
483 abs_time_t timeout; /* absolute timeout */
484 VARARG(handles,handles); /* handles to select on */
487 #define SELECT_ALERTABLE 2
488 #define SELECT_INTERRUPTIBLE 4
489 #define SELECT_TIMEOUT 8
492 /* Create an event */
494 int manual_reset; /* manual reset event */
495 int initial_state; /* initial state of the event */
496 int inherit; /* inherit flag */
497 VARARG(name,unicode_str); /* object name */
499 obj_handle_t handle; /* handle to the event */
502 /* Event operation */
504 obj_handle_t handle; /* handle to event */
505 int op; /* event operation (see below) */
507 enum event_op { PULSE_EVENT, SET_EVENT, RESET_EVENT };
512 unsigned int access; /* wanted access rights */
513 int inherit; /* inherit flag */
514 VARARG(name,unicode_str); /* object name */
516 obj_handle_t handle; /* handle to the event */
522 int owned; /* initially owned? */
523 int inherit; /* inherit flag */
524 VARARG(name,unicode_str); /* object name */
526 obj_handle_t handle; /* handle to the mutex */
530 /* Release a mutex */
532 obj_handle_t handle; /* handle to the mutex */
538 unsigned int access; /* wanted access rights */
539 int inherit; /* inherit flag */
540 VARARG(name,unicode_str); /* object name */
542 obj_handle_t handle; /* handle to the mutex */
546 /* Create a semaphore */
547 @REQ(create_semaphore)
548 unsigned int initial; /* initial count */
549 unsigned int max; /* maximum count */
550 int inherit; /* inherit flag */
551 VARARG(name,unicode_str); /* object name */
553 obj_handle_t handle; /* handle to the semaphore */
557 /* Release a semaphore */
558 @REQ(release_semaphore)
559 obj_handle_t handle; /* handle to the semaphore */
560 unsigned int count; /* count to add to semaphore */
562 unsigned int prev_count; /* previous semaphore count */
566 /* Open a semaphore */
568 unsigned int access; /* wanted access rights */
569 int inherit; /* inherit flag */
570 VARARG(name,unicode_str); /* object name */
572 obj_handle_t handle; /* handle to the semaphore */
578 unsigned int access; /* wanted access rights */
579 int inherit; /* inherit flag */
580 unsigned int sharing; /* sharing flags */
581 int create; /* file create action */
582 unsigned int options; /* file options */
583 unsigned int attrs; /* file attributes for creation */
584 VARARG(filename,string); /* file name */
586 obj_handle_t handle; /* handle to the file */
590 /* Allocate a file handle for a Unix fd */
591 @REQ(alloc_file_handle)
592 unsigned int access; /* wanted access rights */
593 int inherit; /* inherit flag */
594 int fd; /* file descriptor on the client side */
596 obj_handle_t handle; /* handle to the file */
600 /* Get a Unix fd to access a file */
602 obj_handle_t handle; /* handle to the file */
603 unsigned int access; /* wanted access rights */
605 int fd; /* file descriptor */
606 int flags; /* file read/write flags (see below) */
608 #define FD_FLAG_OVERLAPPED 0x01 /* fd opened in overlapped mode */
609 #define FD_FLAG_TIMEOUT 0x02 /* read/write is synchronous */
610 #define FD_FLAG_RECV_SHUTDOWN 0x04
611 #define FD_FLAG_SEND_SHUTDOWN 0x08
612 #define FD_FLAG_AVAILABLE 0x10 /* in overlap read/write operation,
613 * only handle available data (don't wait) */
616 /* Flush a file buffers */
618 obj_handle_t handle; /* handle to the file */
620 obj_handle_t event; /* event set when finished */
624 /* Lock a region of a file */
626 obj_handle_t handle; /* handle to the file */
627 unsigned int offset_low; /* offset of start of lock */
628 unsigned int offset_high; /* offset of start of lock */
629 unsigned int count_low; /* count of bytes to lock */
630 unsigned int count_high; /* count of bytes to lock */
631 int shared; /* shared or exclusive lock? */
632 int wait; /* do we want to wait? */
634 obj_handle_t handle; /* handle to wait on */
635 int overlapped; /* is it an overlapped I/O handle? */
639 /* Unlock a region of a file */
641 obj_handle_t handle; /* handle to the file */
642 unsigned int offset_low; /* offset of start of unlock */
643 unsigned int offset_high; /* offset of start of unlock */
644 unsigned int count_low; /* count of bytes to unlock */
645 unsigned int count_high; /* count of bytes to unlock */
649 /* Create a socket */
651 unsigned int access; /* wanted access rights */
652 int inherit; /* inherit flag */
653 int family; /* family, see socket manpage */
654 int type; /* type, see socket manpage */
655 int protocol; /* protocol, see socket manpage */
656 unsigned int flags; /* socket flags */
658 obj_handle_t handle; /* handle to the new socket */
662 /* Accept a socket */
664 obj_handle_t lhandle; /* handle to the listening socket */
665 unsigned int access; /* wanted access rights */
666 int inherit; /* inherit flag */
668 obj_handle_t handle; /* handle to the new socket */
672 /* Set socket event parameters */
673 @REQ(set_socket_event)
674 obj_handle_t handle; /* handle to the socket */
675 unsigned int mask; /* event mask */
676 obj_handle_t event; /* event object */
677 user_handle_t window; /* window to send the message to */
678 unsigned int msg; /* message to send */
682 /* Get socket event parameters */
683 @REQ(get_socket_event)
684 obj_handle_t handle; /* handle to the socket */
685 int service; /* clear pending? */
686 obj_handle_t c_event; /* event to clear */
688 unsigned int mask; /* event mask */
689 unsigned int pmask; /* pending events */
690 unsigned int state; /* status bits */
691 VARARG(errors,ints); /* event errors */
695 /* Reenable pending socket events */
696 @REQ(enable_socket_event)
697 obj_handle_t handle; /* handle to the socket */
698 unsigned int mask; /* events to re-enable */
699 unsigned int sstate; /* status bits to set */
700 unsigned int cstate; /* status bits to clear */
703 @REQ(set_socket_deferred)
704 obj_handle_t handle; /* handle to the socket */
705 obj_handle_t deferred; /* handle to the socket for which accept() is deferred */
708 /* Allocate a console (only used by a console renderer) */
710 unsigned int access; /* wanted access rights */
711 int inherit; /* inherit flag */
712 process_id_t pid; /* pid of process which shall be attached to the console */
714 obj_handle_t handle_in; /* handle to console input */
715 obj_handle_t event; /* handle to renderer events change notification */
719 /* Free the console of the current process */
724 #define CONSOLE_RENDERER_NONE_EVENT 0x00
725 #define CONSOLE_RENDERER_TITLE_EVENT 0x01
726 #define CONSOLE_RENDERER_ACTIVE_SB_EVENT 0x02
727 #define CONSOLE_RENDERER_SB_RESIZE_EVENT 0x03
728 #define CONSOLE_RENDERER_UPDATE_EVENT 0x04
729 #define CONSOLE_RENDERER_CURSOR_POS_EVENT 0x05
730 #define CONSOLE_RENDERER_CURSOR_GEOM_EVENT 0x06
731 #define CONSOLE_RENDERER_DISPLAY_EVENT 0x07
732 #define CONSOLE_RENDERER_EXIT_EVENT 0x08
733 struct console_renderer_event
768 /* retrieve console events for the renderer */
769 @REQ(get_console_renderer_events)
770 obj_handle_t handle; /* handle to console input events */
772 VARARG(data,bytes); /* the various console_renderer_events */
776 /* Open a handle to the process console */
778 int from; /* 0 (resp 1) input (resp output) of current process console */
779 /* otherwise console_in handle to get active screen buffer? */
780 unsigned int access; /* wanted access rights */
781 int inherit; /* inherit flag */
782 int share; /* share mask (only for output handles) */
784 obj_handle_t handle; /* handle to the console */
788 /* Get the input queue wait event */
789 @REQ(get_console_wait_event)
794 /* Get a console mode (input or output) */
795 @REQ(get_console_mode)
796 obj_handle_t handle; /* handle to the console */
798 int mode; /* console mode */
802 /* Set a console mode (input or output) */
803 @REQ(set_console_mode)
804 obj_handle_t handle; /* handle to the console */
805 int mode; /* console mode */
809 /* Set info about a console (input only) */
810 @REQ(set_console_input_info)
811 obj_handle_t handle; /* handle to console input, or 0 for process' console */
812 int mask; /* setting mask (see below) */
813 obj_handle_t active_sb; /* active screen buffer */
814 int history_mode; /* whether we duplicate lines in history */
815 int history_size; /* number of lines in history */
816 int edition_mode; /* index to the edition mode flavors */
817 VARARG(title,unicode_str); /* console title */
819 #define SET_CONSOLE_INPUT_INFO_ACTIVE_SB 0x01
820 #define SET_CONSOLE_INPUT_INFO_TITLE 0x02
821 #define SET_CONSOLE_INPUT_INFO_HISTORY_MODE 0x04
822 #define SET_CONSOLE_INPUT_INFO_HISTORY_SIZE 0x08
823 #define SET_CONSOLE_INPUT_INFO_EDITION_MODE 0x10
826 /* Get info about a console (input only) */
827 @REQ(get_console_input_info)
828 obj_handle_t handle; /* handle to console input, or 0 for process' console */
830 int history_mode; /* whether we duplicate lines in history */
831 int history_size; /* number of lines in history */
832 int history_index; /* number of used lines in history */
833 int edition_mode; /* index to the edition mode flavors */
834 VARARG(title,unicode_str); /* console title */
838 /* appends a string to console's history */
839 @REQ(append_console_input_history)
840 obj_handle_t handle; /* handle to console input, or 0 for process' console */
841 VARARG(line,unicode_str); /* line to add */
845 /* appends a string to console's history */
846 @REQ(get_console_input_history)
847 obj_handle_t handle; /* handle to console input, or 0 for process' console */
848 int index; /* index to get line from */
850 int total; /* total length of line in Unicode chars */
851 VARARG(line,unicode_str); /* line to add */
855 /* creates a new screen buffer on process' console */
856 @REQ(create_console_output)
857 obj_handle_t handle_in; /* handle to console input, or 0 for process' console */
858 int access; /* wanted access rights */
859 int share; /* sharing credentials */
860 int inherit; /* inherit flag */
862 obj_handle_t handle_out; /* handle to the screen buffer */
866 /* Set info about a console (output only) */
867 @REQ(set_console_output_info)
868 obj_handle_t handle; /* handle to the console */
869 int mask; /* setting mask (see below) */
870 short int cursor_size; /* size of cursor (percentage filled) */
871 short int cursor_visible;/* cursor visibility flag */
872 short int cursor_x; /* position of cursor (x, y) */
874 short int width; /* width of the screen buffer */
875 short int height; /* height of the screen buffer */
876 short int attr; /* default attribute */
877 short int win_left; /* window actually displayed by renderer */
878 short int win_top; /* the rect area is expressed withing the */
879 short int win_right; /* boundaries of the screen buffer */
880 short int win_bottom;
881 short int max_width; /* maximum size (width x height) for the window */
882 short int max_height;
884 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_GEOM 0x01
885 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_POS 0x02
886 #define SET_CONSOLE_OUTPUT_INFO_SIZE 0x04
887 #define SET_CONSOLE_OUTPUT_INFO_ATTR 0x08
888 #define SET_CONSOLE_OUTPUT_INFO_DISPLAY_WINDOW 0x10
889 #define SET_CONSOLE_OUTPUT_INFO_MAX_SIZE 0x20
892 /* Get info about a console (output only) */
893 @REQ(get_console_output_info)
894 obj_handle_t handle; /* handle to the console */
896 short int cursor_size; /* size of cursor (percentage filled) */
897 short int cursor_visible;/* cursor visibility flag */
898 short int cursor_x; /* position of cursor (x, y) */
900 short int width; /* width of the screen buffer */
901 short int height; /* height of the screen buffer */
902 short int attr; /* default attribute */
903 short int win_left; /* window actually displayed by renderer */
904 short int win_top; /* the rect area is expressed withing the */
905 short int win_right; /* boundaries of the screen buffer */
906 short int win_bottom;
907 short int max_width; /* maximum size (width x height) for the window */
908 short int max_height;
911 /* Add input records to a console input queue */
912 @REQ(write_console_input)
913 obj_handle_t handle; /* handle to the console input */
914 VARARG(rec,input_records); /* input records */
916 int written; /* number of records written */
920 /* Fetch input records from a console input queue */
921 @REQ(read_console_input)
922 obj_handle_t handle; /* handle to the console input */
923 int flush; /* flush the retrieved records from the queue? */
925 int read; /* number of records read */
926 VARARG(rec,input_records); /* input records */
930 /* write data (chars and/or attributes) in a screen buffer */
931 @REQ(write_console_output)
932 obj_handle_t handle; /* handle to the console output */
933 int x; /* position where to start writing */
935 int mode; /* char info (see below) */
936 int wrap; /* wrap around at end of line? */
937 VARARG(data,bytes); /* info to write */
939 int written; /* number of char infos actually written */
940 int width; /* width of screen buffer */
941 int height; /* height of screen buffer */
945 CHAR_INFO_MODE_TEXT, /* characters only */
946 CHAR_INFO_MODE_ATTR, /* attributes only */
947 CHAR_INFO_MODE_TEXTATTR, /* both characters and attributes */
948 CHAR_INFO_MODE_TEXTSTDATTR /* characters but use standard attributes */
952 /* fill a screen buffer with constant data (chars and/or attributes) */
953 @REQ(fill_console_output)
954 obj_handle_t handle; /* handle to the console output */
955 int x; /* position where to start writing */
957 int mode; /* char info mode */
958 int count; /* number to write */
959 int wrap; /* wrap around at end of line? */
960 char_info_t data; /* data to write */
962 int written; /* number of char infos actually written */
966 /* read data (chars and/or attributes) from a screen buffer */
967 @REQ(read_console_output)
968 obj_handle_t handle; /* handle to the console output */
969 int x; /* position (x,y) where to start reading */
971 int mode; /* char info mode */
972 int wrap; /* wrap around at end of line? */
974 int width; /* width of screen buffer */
975 int height; /* height of screen buffer */
980 /* move a rect (of data) in screen buffer content */
981 @REQ(move_console_output)
982 obj_handle_t handle; /* handle to the console output */
983 short int x_src; /* position (x, y) of rect to start moving from */
985 short int x_dst; /* position (x, y) of rect to move to */
987 short int w; /* size of the rect (width, height) to move */
992 /* Sends a signal to a process group */
993 @REQ(send_console_signal)
994 int signal; /* the signal to send */
995 process_id_t group_id; /* the group to send the signal to */
999 /* Create a change notification */
1000 @REQ(create_change_notification)
1001 obj_handle_t handle; /* handle to the directory */
1002 int subtree; /* watch all the subtree */
1003 unsigned int filter; /* notification filter */
1005 obj_handle_t handle; /* handle to the change notification */
1009 /* Move to the next change notification */
1010 @REQ(next_change_notification)
1011 obj_handle_t handle; /* handle to the change notification */
1014 /* Create a file mapping */
1015 @REQ(create_mapping)
1016 int size_high; /* mapping size */
1017 int size_low; /* mapping size */
1018 int protect; /* protection flags (see below) */
1019 unsigned int access; /* wanted access rights */
1020 int inherit; /* inherit flag */
1021 obj_handle_t file_handle; /* file handle */
1022 VARARG(name,unicode_str); /* object name */
1024 obj_handle_t handle; /* handle to the mapping */
1026 /* protection flags */
1027 #define VPROT_READ 0x01
1028 #define VPROT_WRITE 0x02
1029 #define VPROT_EXEC 0x04
1030 #define VPROT_WRITECOPY 0x08
1031 #define VPROT_GUARD 0x10
1032 #define VPROT_NOCACHE 0x20
1033 #define VPROT_COMMITTED 0x40
1034 #define VPROT_IMAGE 0x80
1037 /* Open a mapping */
1039 unsigned int access; /* wanted access rights */
1040 int inherit; /* inherit flag */
1041 VARARG(name,unicode_str); /* object name */
1043 obj_handle_t handle; /* handle to the mapping */
1047 /* Get information about a file mapping */
1048 @REQ(get_mapping_info)
1049 obj_handle_t handle; /* handle to the mapping */
1051 int size_high; /* mapping size */
1052 int size_low; /* mapping size */
1053 int protect; /* protection flags */
1054 int header_size; /* header size (for VPROT_IMAGE mapping) */
1055 void* base; /* default base addr (for VPROT_IMAGE mapping) */
1056 obj_handle_t shared_file; /* shared mapping file handle */
1057 int shared_size; /* shared mapping size */
1061 #define SNAP_HEAPLIST 0x00000001
1062 #define SNAP_PROCESS 0x00000002
1063 #define SNAP_THREAD 0x00000004
1064 #define SNAP_MODULE 0x00000008
1065 /* Create a snapshot */
1066 @REQ(create_snapshot)
1067 int inherit; /* inherit flag */
1068 int flags; /* snapshot flags (SNAP_*) */
1069 process_id_t pid; /* process id */
1071 obj_handle_t handle; /* handle to the snapshot */
1075 /* Get the next process from a snapshot */
1077 obj_handle_t handle; /* handle to the snapshot */
1078 int reset; /* reset snapshot position? */
1080 int count; /* process usage count */
1081 process_id_t pid; /* process id */
1082 process_id_t ppid; /* parent process id */
1083 void* heap; /* heap base */
1084 void* module; /* main module */
1085 int threads; /* number of threads */
1086 int priority; /* process priority */
1087 int handles; /* number of handles */
1088 VARARG(filename,unicode_str); /* file name of main exe */
1092 /* Get the next thread from a snapshot */
1094 obj_handle_t handle; /* handle to the snapshot */
1095 int reset; /* reset snapshot position? */
1097 int count; /* thread usage count */
1098 process_id_t pid; /* process id */
1099 thread_id_t tid; /* thread id */
1100 int base_pri; /* base priority */
1101 int delta_pri; /* delta priority */
1105 /* Get the next module from a snapshot */
1107 obj_handle_t handle; /* handle to the snapshot */
1108 int reset; /* reset snapshot position? */
1110 process_id_t pid; /* process id */
1111 void* base; /* module base address */
1112 size_t size; /* module size */
1113 VARARG(filename,unicode_str); /* file name of module */
1117 /* Wait for a debug event */
1118 @REQ(wait_debug_event)
1119 int get_handle; /* should we alloc a handle for waiting? */
1121 process_id_t pid; /* process id */
1122 thread_id_t tid; /* thread id */
1123 obj_handle_t wait; /* wait handle if no event ready */
1124 VARARG(event,debug_event); /* debug event data */
1128 /* Queue an exception event */
1129 @REQ(queue_exception_event)
1130 int first; /* first chance exception? */
1131 VARARG(record,exc_event); /* thread context followed by exception record */
1133 obj_handle_t handle; /* handle to the queued event */
1137 /* Retrieve the status of an exception event */
1138 @REQ(get_exception_status)
1139 obj_handle_t handle; /* handle to the queued event */
1141 int status; /* event continuation status */
1142 VARARG(context,context); /* modified thread context */
1146 /* Send an output string to the debugger */
1147 @REQ(output_debug_string)
1148 void* string; /* string to display (in debugged process address space) */
1149 int unicode; /* is it Unicode? */
1150 int length; /* string length */
1154 /* Continue a debug event */
1155 @REQ(continue_debug_event)
1156 process_id_t pid; /* process id to continue */
1157 thread_id_t tid; /* thread id to continue */
1158 int status; /* continuation status */
1162 /* Start/stop debugging an existing process */
1164 process_id_t pid; /* id of the process to debug */
1165 int attach; /* 1=attaching / 0=detaching from the process */
1169 /* Simulate a breakpoint in a process */
1171 obj_handle_t handle; /* process handle */
1173 int self; /* was it the caller itself? */
1177 /* Set debugger kill on exit flag */
1178 @REQ(set_debugger_kill_on_exit)
1179 int kill_on_exit; /* 0=detach/1=kill debuggee when debugger dies */
1183 /* Read data from a process address space */
1184 @REQ(read_process_memory)
1185 obj_handle_t handle; /* process handle */
1186 void* addr; /* addr to read from */
1188 VARARG(data,bytes); /* result data */
1192 /* Write data to a process address space */
1193 @REQ(write_process_memory)
1194 obj_handle_t handle; /* process handle */
1195 void* addr; /* addr to write to (must be int-aligned) */
1196 unsigned int first_mask; /* mask for first word */
1197 unsigned int last_mask; /* mask for last word */
1198 VARARG(data,bytes); /* data to write */
1202 /* Create a registry key */
1204 obj_handle_t parent; /* handle to the parent key */
1205 unsigned int access; /* desired access rights */
1206 unsigned int options; /* creation options */
1207 time_t modif; /* last modification time */
1208 size_t namelen; /* length of key name in bytes */
1209 VARARG(name,unicode_str,namelen); /* key name */
1210 VARARG(class,unicode_str); /* class name */
1212 obj_handle_t hkey; /* handle to the created key */
1213 int created; /* has it been newly created? */
1216 /* Open a registry key */
1218 obj_handle_t parent; /* handle to the parent key */
1219 unsigned int access; /* desired access rights */
1220 VARARG(name,unicode_str); /* key name */
1222 obj_handle_t hkey; /* handle to the open key */
1226 /* Delete a registry key */
1228 obj_handle_t hkey; /* handle to the key */
1232 /* Flush a registry key */
1234 obj_handle_t hkey; /* handle to the key */
1238 /* Enumerate registry subkeys */
1240 obj_handle_t hkey; /* handle to registry key */
1241 int index; /* index of subkey (or -1 for current key) */
1242 int info_class; /* requested information class */
1244 int subkeys; /* number of subkeys */
1245 int max_subkey; /* longest subkey name */
1246 int max_class; /* longest class name */
1247 int values; /* number of values */
1248 int max_value; /* longest value name */
1249 int max_data; /* longest value data */
1250 time_t modif; /* last modification time */
1251 size_t total; /* total length needed for full name and class */
1252 size_t namelen; /* length of key name in bytes */
1253 VARARG(name,unicode_str,namelen); /* key name */
1254 VARARG(class,unicode_str); /* class name */
1258 /* Set a value of a registry key */
1260 obj_handle_t hkey; /* handle to registry key */
1261 int type; /* value type */
1262 size_t namelen; /* length of value name in bytes */
1263 VARARG(name,unicode_str,namelen); /* value name */
1264 VARARG(data,bytes); /* value data */
1268 /* Retrieve the value of a registry key */
1270 obj_handle_t hkey; /* handle to registry key */
1271 VARARG(name,unicode_str); /* value name */
1273 int type; /* value type */
1274 size_t total; /* total length needed for data */
1275 VARARG(data,bytes); /* value data */
1279 /* Enumerate a value of a registry key */
1280 @REQ(enum_key_value)
1281 obj_handle_t hkey; /* handle to registry key */
1282 int index; /* value index */
1283 int info_class; /* requested information class */
1285 int type; /* value type */
1286 size_t total; /* total length needed for full name and data */
1287 size_t namelen; /* length of value name in bytes */
1288 VARARG(name,unicode_str,namelen); /* value name */
1289 VARARG(data,bytes); /* value data */
1293 /* Delete a value of a registry key */
1294 @REQ(delete_key_value)
1295 obj_handle_t hkey; /* handle to registry key */
1296 VARARG(name,unicode_str); /* value name */
1300 /* Load a registry branch from a file */
1302 obj_handle_t hkey; /* root key to load to */
1303 obj_handle_t file; /* file to load from */
1304 VARARG(name,unicode_str); /* subkey name */
1308 /* UnLoad a registry branch from a file */
1309 @REQ(unload_registry)
1310 obj_handle_t hkey; /* root key to unload to */
1314 /* Save a registry branch to a file */
1316 obj_handle_t hkey; /* key to save */
1317 obj_handle_t file; /* file to save to */
1321 /* Load the user registry files */
1322 @REQ(load_user_registries)
1323 obj_handle_t hkey; /* key for HKCU */
1324 int saving; /* new saving level */
1325 int period; /* duration between periodic saves (milliseconds) */
1329 /* Add a registry key change notification */
1330 @REQ(set_registry_notification)
1331 obj_handle_t hkey; /* key to watch for changes */
1332 obj_handle_t event; /* event to set */
1333 int subtree; /* should we watch the whole subtree? */
1334 unsigned int filter; /* things to watch */
1338 /* Create a waitable timer */
1340 int inherit; /* inherit flag */
1341 int manual; /* manual reset */
1342 VARARG(name,unicode_str); /* object name */
1344 obj_handle_t handle; /* handle to the timer */
1348 /* Open a waitable timer */
1350 unsigned int access; /* wanted access rights */
1351 int inherit; /* inherit flag */
1352 VARARG(name,unicode_str); /* object name */
1354 obj_handle_t handle; /* handle to the timer */
1357 /* Set a waitable timer */
1359 obj_handle_t handle; /* handle to the timer */
1360 abs_time_t expire; /* next expiration absolute time */
1361 int period; /* timer period in ms */
1362 void* callback; /* callback function */
1363 void* arg; /* callback argument */
1365 int signaled; /* was the timer signaled before this call ? */
1368 /* Cancel a waitable timer */
1370 obj_handle_t handle; /* handle to the timer */
1372 int signaled; /* was the timer signaled before this calltime ? */
1376 /* Retrieve the current context of a thread */
1377 @REQ(get_thread_context)
1378 obj_handle_t handle; /* thread handle */
1379 unsigned int flags; /* context flags */
1381 VARARG(context,context); /* thread context */
1385 /* Set the current context of a thread */
1386 @REQ(set_thread_context)
1387 obj_handle_t handle; /* thread handle */
1388 unsigned int flags; /* context flags */
1389 VARARG(context,context); /* thread context */
1393 /* Fetch a selector entry for a thread */
1394 @REQ(get_selector_entry)
1395 obj_handle_t handle; /* thread handle */
1396 int entry; /* LDT entry */
1398 unsigned int base; /* selector base */
1399 unsigned int limit; /* selector limit */
1400 unsigned char flags; /* selector flags */
1406 int local; /* is atom in local process table? */
1407 VARARG(name,unicode_str); /* atom name */
1409 atom_t atom; /* resulting atom */
1413 /* Delete an atom */
1415 atom_t atom; /* atom handle */
1416 int local; /* is atom in local process table? */
1422 int local; /* is atom in local process table? */
1423 VARARG(name,unicode_str); /* atom name */
1425 atom_t atom; /* atom handle */
1429 /* Get an atom name */
1431 atom_t atom; /* atom handle */
1432 int local; /* is atom in local process table? */
1434 int count; /* atom lock count */
1435 VARARG(name,unicode_str); /* atom name */
1439 /* Init the process atom table */
1440 @REQ(init_atom_table)
1441 int entries; /* number of entries */
1445 /* Get the message queue of the current thread */
1448 obj_handle_t handle; /* handle to the queue */
1452 /* Set the current message queue wakeup mask */
1453 @REQ(set_queue_mask)
1454 unsigned int wake_mask; /* wakeup bits mask */
1455 unsigned int changed_mask; /* changed bits mask */
1456 int skip_wait; /* will we skip waiting if signaled? */
1458 unsigned int wake_bits; /* current wake bits */
1459 unsigned int changed_bits; /* current changed bits */
1463 /* Get the current message queue status */
1464 @REQ(get_queue_status)
1465 int clear; /* should we clear the change bits? */
1467 unsigned int wake_bits; /* wake bits */
1468 unsigned int changed_bits; /* changed bits since last time */
1472 /* Wait for a process to start waiting on input */
1473 @REQ(wait_input_idle)
1474 obj_handle_t handle; /* process handle */
1475 int timeout; /* timeout */
1477 obj_handle_t event; /* handle to idle event */
1481 /* Send a message to a thread queue */
1483 thread_id_t id; /* thread id */
1484 int type; /* message type (see below) */
1485 int flags; /* message flags (see below) */
1486 user_handle_t win; /* window handle */
1487 unsigned int msg; /* message code */
1488 unsigned int wparam; /* parameters */
1489 unsigned int lparam; /* parameters */
1490 int x; /* x position */
1491 int y; /* y position */
1492 unsigned int time; /* message time */
1493 unsigned int info; /* extra info */
1494 int timeout; /* timeout for reply */
1495 void* callback; /* callback address */
1496 VARARG(data,bytes); /* message data for sent messages */
1501 MSG_ASCII, /* Ascii message (from SendMessageA) */
1502 MSG_UNICODE, /* Unicode message (from SendMessageW) */
1503 MSG_NOTIFY, /* notify message (from SendNotifyMessageW), always Unicode */
1504 MSG_CALLBACK, /* callback message (from SendMessageCallbackW), always Unicode */
1505 MSG_CALLBACK_RESULT,/* result of a callback message */
1506 MSG_OTHER_PROCESS, /* sent from other process, may include vararg data, always Unicode */
1507 MSG_POSTED, /* posted message (from PostMessageW), always Unicode */
1508 MSG_HARDWARE /* hardware message */
1510 #define SEND_MSG_ABORT_IF_HUNG 0x01
1513 /* Get a message from the current queue */
1515 int flags; /* see below */
1516 user_handle_t get_win; /* window handle to get */
1517 unsigned int get_first; /* first message code to get */
1518 unsigned int get_last; /* last message code to get */
1520 int type; /* message type */
1521 user_handle_t win; /* window handle */
1522 unsigned int msg; /* message code */
1523 unsigned int wparam; /* parameters (callback function for MSG_CALLBACK_RESULT) */
1524 unsigned int lparam; /* parameters (result for MSG_CALLBACK_RESULT) */
1525 int x; /* x position */
1526 int y; /* y position */
1527 unsigned int time; /* message time */
1528 unsigned int info; /* extra info (callback argument for MSG_CALLBACK_RESULT) */
1529 size_t total; /* total size of extra data */
1530 VARARG(data,bytes); /* message data for sent messages */
1532 #define GET_MSG_REMOVE 1 /* remove the message */
1533 #define GET_MSG_SENT_ONLY 2 /* only get sent messages */
1535 /* Reply to a sent message */
1537 int type; /* type of original message */
1538 unsigned int result; /* message result */
1539 int remove; /* should we remove the message? */
1540 VARARG(data,bytes); /* message data for sent messages */
1544 /* Retrieve the reply for the last message sent */
1545 @REQ(get_message_reply)
1546 int cancel; /* cancel message if not ready? */
1548 unsigned int result; /* message result */
1549 VARARG(data,bytes); /* message data for sent messages */
1553 /* Set a window timer */
1555 user_handle_t win; /* window handle */
1556 unsigned int msg; /* message to post */
1557 unsigned int id; /* timer id */
1558 unsigned int rate; /* timer rate in ms */
1559 unsigned int lparam; /* message lparam (callback proc) */
1563 /* Kill a window timer */
1564 @REQ(kill_win_timer)
1565 user_handle_t win; /* window handle */
1566 unsigned int msg; /* message to post */
1567 unsigned int id; /* timer id */
1571 /* Retrieve info about a serial port */
1572 @REQ(get_serial_info)
1573 obj_handle_t handle; /* handle to comm port */
1575 unsigned int readinterval;
1576 unsigned int readconst;
1577 unsigned int readmult;
1578 unsigned int writeconst;
1579 unsigned int writemult;
1580 unsigned int eventmask;
1581 unsigned int commerror;
1585 /* Set info about a serial port */
1586 @REQ(set_serial_info)
1587 obj_handle_t handle; /* handle to comm port */
1588 int flags; /* bitmask to set values (see below) */
1589 unsigned int readinterval;
1590 unsigned int readconst;
1591 unsigned int readmult;
1592 unsigned int writeconst;
1593 unsigned int writemult;
1594 unsigned int eventmask;
1595 unsigned int commerror;
1597 #define SERIALINFO_SET_TIMEOUTS 0x01
1598 #define SERIALINFO_SET_MASK 0x02
1599 #define SERIALINFO_SET_ERROR 0x04
1602 /* Create / reschedule an async I/O */
1603 @REQ(register_async)
1604 obj_handle_t handle; /* handle to comm port, socket or file */
1608 unsigned int status;
1610 #define ASYNC_TYPE_NONE 0x00
1611 #define ASYNC_TYPE_READ 0x01
1612 #define ASYNC_TYPE_WRITE 0x02
1613 #define ASYNC_TYPE_WAIT 0x03
1616 /* Create a named pipe */
1617 @REQ(create_named_pipe)
1618 unsigned int openmode;
1619 unsigned int pipemode;
1620 unsigned int maxinstances;
1621 unsigned int outsize;
1622 unsigned int insize;
1623 unsigned int timeout;
1624 int inherit; /* inherit flag */
1625 VARARG(name,unicode_str); /* pipe name */
1627 obj_handle_t handle; /* handle to the pipe */
1631 /* Open an existing named pipe */
1632 @REQ(open_named_pipe)
1633 unsigned int access;
1634 int inherit; /* inherit flag */
1635 VARARG(name,unicode_str); /* pipe name */
1637 obj_handle_t handle; /* handle to the pipe */
1641 /* Connect to a named pipe */
1642 @REQ(connect_named_pipe)
1643 obj_handle_t handle;
1649 /* Wait for a named pipe */
1650 @REQ(wait_named_pipe)
1651 unsigned int timeout;
1654 VARARG(name,unicode_str); /* pipe name */
1658 /* Disconnect a named pipe */
1659 @REQ(disconnect_named_pipe)
1660 obj_handle_t handle;
1662 int fd; /* associated fd to close */
1666 @REQ(get_named_pipe_info)
1667 obj_handle_t handle;
1670 unsigned int maxinstances;
1671 unsigned int outsize;
1672 unsigned int insize;
1676 /* Create a window */
1678 user_handle_t parent; /* parent window */
1679 user_handle_t owner; /* owner window */
1680 atom_t atom; /* class atom */
1681 void* instance; /* module instance */
1683 user_handle_t handle; /* created window */
1684 int extra; /* number of extra bytes */
1685 void* class_ptr; /* pointer to class in client address space */
1689 /* Link a window into the tree */
1691 user_handle_t handle; /* handle to the window */
1692 user_handle_t parent; /* handle to the parent */
1693 user_handle_t previous; /* previous child in Z-order */
1695 user_handle_t full_parent; /* full handle of new parent */
1699 /* Destroy a window */
1700 @REQ(destroy_window)
1701 user_handle_t handle; /* handle to the window */
1705 /* Set a window owner */
1706 @REQ(set_window_owner)
1707 user_handle_t handle; /* handle to the window */
1708 user_handle_t owner; /* new owner */
1710 user_handle_t full_owner; /* full handle of new owner */
1711 user_handle_t prev_owner; /* full handle of previous owner */
1715 /* Get information from a window handle */
1716 @REQ(get_window_info)
1717 user_handle_t handle; /* handle to the window */
1719 user_handle_t full_handle; /* full 32-bit handle */
1720 user_handle_t last_active; /* last active popup */
1721 process_id_t pid; /* process owning the window */
1722 thread_id_t tid; /* thread owning the window */
1723 atom_t atom; /* class atom */
1727 /* Set some information in a window */
1728 @REQ(set_window_info)
1729 user_handle_t handle; /* handle to the window */
1730 unsigned int flags; /* flags for fields to set (see below) */
1731 unsigned int style; /* window style */
1732 unsigned int ex_style; /* window extended style */
1733 unsigned int id; /* window id */
1734 void* instance; /* creator instance */
1735 void* user_data; /* user-specific data */
1736 int extra_offset; /* offset to set in extra bytes */
1737 size_t extra_size; /* size to set in extra bytes */
1738 unsigned int extra_value; /* value to set in extra bytes */
1740 unsigned int old_style; /* old window style */
1741 unsigned int old_ex_style; /* old window extended style */
1742 unsigned int old_id; /* old window id */
1743 void* old_instance; /* old creator instance */
1744 void* old_user_data; /* old user-specific data */
1745 unsigned int old_extra_value; /* old value in extra bytes */
1747 #define SET_WIN_STYLE 0x01
1748 #define SET_WIN_EXSTYLE 0x02
1749 #define SET_WIN_ID 0x04
1750 #define SET_WIN_INSTANCE 0x08
1751 #define SET_WIN_USERDATA 0x10
1752 #define SET_WIN_EXTRA 0x20
1755 /* Get a list of the window parents, up to the root of the tree */
1756 @REQ(get_window_parents)
1757 user_handle_t handle; /* handle to the window */
1759 int count; /* total count of parents */
1760 VARARG(parents,user_handles); /* parent handles */
1764 /* Get a list of the window children */
1765 @REQ(get_window_children)
1766 user_handle_t parent; /* parent window */
1767 atom_t atom; /* class atom for the listed children */
1768 thread_id_t tid; /* thread owning the listed children */
1770 int count; /* total count of children */
1771 VARARG(children,user_handles); /* children handles */
1775 /* Get a list of the window children that contain a given point */
1776 @REQ(get_window_children_from_point)
1777 user_handle_t parent; /* parent window */
1778 int x; /* point in parent coordinates */
1781 int count; /* total count of children */
1782 VARARG(children,user_handles); /* children handles */
1786 /* Get window tree information from a window handle */
1787 @REQ(get_window_tree)
1788 user_handle_t handle; /* handle to the window */
1790 user_handle_t parent; /* parent window */
1791 user_handle_t owner; /* owner window */
1792 user_handle_t next_sibling; /* next sibling in Z-order */
1793 user_handle_t prev_sibling; /* prev sibling in Z-order */
1794 user_handle_t first_sibling; /* first sibling in Z-order */
1795 user_handle_t last_sibling; /* last sibling in Z-order */
1796 user_handle_t first_child; /* first child */
1797 user_handle_t last_child; /* last child */
1800 /* Set the window and client rectangles of a window */
1801 @REQ(set_window_rectangles)
1802 user_handle_t handle; /* handle to the window */
1803 rectangle_t window; /* window rectangle */
1804 rectangle_t client; /* client rectangle */
1808 /* Get the window and client rectangles of a window */
1809 @REQ(get_window_rectangles)
1810 user_handle_t handle; /* handle to the window */
1812 rectangle_t window; /* window rectangle */
1813 rectangle_t client; /* client rectangle */
1817 /* Get the window text */
1818 @REQ(get_window_text)
1819 user_handle_t handle; /* handle to the window */
1821 VARARG(text,unicode_str); /* window text */
1825 /* Set the window text */
1826 @REQ(set_window_text)
1827 user_handle_t handle; /* handle to the window */
1828 VARARG(text,unicode_str); /* window text */
1832 /* Increment the window paint count */
1833 @REQ(inc_window_paint_count)
1834 user_handle_t handle; /* handle to the window */
1835 int incr; /* increment (can be negative) */
1839 /* Get the coordinates offset between two windows */
1840 @REQ(get_windows_offset)
1841 user_handle_t from; /* handle to the first window */
1842 user_handle_t to; /* handle to the second window */
1844 int x; /* x coordinate offset */
1845 int y; /* y coordinate offset */
1849 /* Get the visible region of a window */
1850 @REQ(get_visible_region)
1851 user_handle_t window; /* handle to the window */
1852 user_handle_t top_win; /* top window to clip against */
1853 unsigned int flags; /* DCX flags */
1855 size_t total_size; /* total size of the resulting region */
1856 VARARG(region,rectangles); /* list of rectangles for the region */
1860 /* Get the window region */
1861 @REQ(get_window_region)
1862 user_handle_t window; /* handle to the window */
1864 size_t total_size; /* total size of the resulting region */
1865 VARARG(region,rectangles); /* list of rectangles for the region */
1869 /* Set the window region */
1870 @REQ(set_window_region)
1871 user_handle_t window; /* handle to the window */
1872 VARARG(region,rectangles); /* list of rectangles for the region */
1876 /* Set a window property */
1877 @REQ(set_window_property)
1878 user_handle_t window; /* handle to the window */
1879 atom_t atom; /* property atom (high-word set if it was a string) */
1880 int string; /* was atom a string originally? */
1881 obj_handle_t handle; /* handle to store */
1885 /* Remove a window property */
1886 @REQ(remove_window_property)
1887 user_handle_t window; /* handle to the window */
1888 atom_t atom; /* property atom */
1890 obj_handle_t handle; /* handle stored in property */
1894 /* Get a window property */
1895 @REQ(get_window_property)
1896 user_handle_t window; /* handle to the window */
1897 atom_t atom; /* property atom */
1899 obj_handle_t handle; /* handle stored in property */
1903 /* Get the list of properties of a window */
1904 @REQ(get_window_properties)
1905 user_handle_t window; /* handle to the window */
1907 int total; /* total number of properties */
1908 VARARG(props,properties); /* list of properties */
1912 /* Attach (or detach) thread inputs */
1913 @REQ(attach_thread_input)
1914 thread_id_t tid_from; /* thread to be attached */
1915 thread_id_t tid_to; /* thread to which tid_from should be attached */
1916 int attach; /* is it an attach? */
1920 /* Get input data for a given thread */
1921 @REQ(get_thread_input)
1922 thread_id_t tid; /* id of thread */
1924 user_handle_t focus; /* handle to the focus window */
1925 user_handle_t capture; /* handle to the capture window */
1926 user_handle_t active; /* handle to the active window */
1927 user_handle_t foreground; /* handle to the global foreground window */
1928 user_handle_t menu_owner; /* handle to the menu owner */
1929 user_handle_t move_size; /* handle to the moving/resizing window */
1930 user_handle_t caret; /* handle to the caret window */
1931 rectangle_t rect; /* caret rectangle */
1934 /* Retrieve queue keyboard state for a given thread */
1936 thread_id_t tid; /* id of thread */
1937 int key; /* optional key code or -1 */
1939 unsigned char state; /* state of specified key */
1940 VARARG(keystate,bytes); /* state array for all the keys */
1943 /* Set queue keyboard state for a given thread */
1945 thread_id_t tid; /* id of thread */
1946 VARARG(keystate,bytes); /* state array for all the keys */
1949 /* Set the system foreground window */
1950 @REQ(set_foreground_window)
1951 user_handle_t handle; /* handle to the foreground window */
1953 user_handle_t previous; /* handle to the previous foreground window */
1954 int send_msg_old; /* whether we have to send a msg to the old window */
1955 int send_msg_new; /* whether we have to send a msg to the new window */
1958 /* Set the current thread focus window */
1959 @REQ(set_focus_window)
1960 user_handle_t handle; /* handle to the focus window */
1962 user_handle_t previous; /* handle to the previous focus window */
1965 /* Set the current thread active window */
1966 @REQ(set_active_window)
1967 user_handle_t handle; /* handle to the active window */
1969 user_handle_t previous; /* handle to the previous active window */
1972 /* Set the current thread capture window */
1973 @REQ(set_capture_window)
1974 user_handle_t handle; /* handle to the capture window */
1975 unsigned int flags; /* capture flags (see below) */
1977 user_handle_t previous; /* handle to the previous capture window */
1978 user_handle_t full_handle; /* full 32-bit handle of new capture window */
1980 #define CAPTURE_MENU 0x01 /* capture is for a menu */
1981 #define CAPTURE_MOVESIZE 0x02 /* capture is for moving/resizing */
1984 /* Set the current thread caret window */
1985 @REQ(set_caret_window)
1986 user_handle_t handle; /* handle to the caret window */
1987 int width; /* caret width */
1988 int height; /* caret height */
1990 user_handle_t previous; /* handle to the previous caret window */
1991 rectangle_t old_rect; /* previous caret rectangle */
1992 int old_hide; /* previous hide count */
1993 int old_state; /* previous caret state (1=on, 0=off) */
1997 /* Set the current thread caret information */
1998 @REQ(set_caret_info)
1999 unsigned int flags; /* caret flags (see below) */
2000 user_handle_t handle; /* handle to the caret window */
2001 int x; /* caret x position */
2002 int y; /* caret y position */
2003 int hide; /* increment for hide count (can be negative to show it) */
2004 int state; /* caret state (1=on, 0=off, -1=toggle current state) */
2006 user_handle_t full_handle; /* handle to the current caret window */
2007 rectangle_t old_rect; /* previous caret rectangle */
2008 int old_hide; /* previous hide count */
2009 int old_state; /* previous caret state (1=on, 0=off) */
2011 #define SET_CARET_POS 0x01 /* set the caret position from x,y */
2012 #define SET_CARET_HIDE 0x02 /* increment the caret hide count */
2013 #define SET_CARET_STATE 0x04 /* set the caret on/off state */
2016 /* Set a window hook */
2018 int id; /* id of the hook */
2019 thread_id_t tid; /* id of thread to set the hook into */
2020 void* proc; /* hook procedure */
2021 int unicode; /* is it a unicode hook? */
2022 VARARG(module,unicode_str); /* module name */
2024 user_handle_t handle; /* handle to the hook */
2028 /* Remove a window hook */
2030 user_handle_t handle; /* handle to the hook */
2031 int id; /* id of the hook if handle is 0 */
2032 void* proc; /* hook procedure if handle is 0 */
2036 /* Start calling a hook chain */
2037 @REQ(start_hook_chain)
2038 int id; /* id of the hook */
2040 user_handle_t handle; /* handle to the next hook */
2041 process_id_t pid; /* process id for low-level keyboard/mouse hooks */
2042 thread_id_t tid; /* thread id for low-level keyboard/mouse hooks */
2043 void* proc; /* hook procedure */
2044 int unicode; /* is it a unicode hook? */
2045 VARARG(module,unicode_str); /* module name */
2049 /* Finished calling a hook chain */
2050 @REQ(finish_hook_chain)
2051 int id; /* id of the hook */
2055 /* Get the next hook to call */
2057 user_handle_t handle; /* handle to the current hook */
2059 user_handle_t next; /* handle to the next hook */
2060 int id; /* id of the next hook */
2061 process_id_t pid; /* process id for low-level keyboard/mouse hooks */
2062 thread_id_t tid; /* thread id for low-level keyboard/mouse hooks */
2063 void* proc; /* next hook procedure */
2064 int prev_unicode; /* was the previous a unicode hook? */
2065 int next_unicode; /* is the next a unicode hook? */
2066 VARARG(module,unicode_str); /* module name */
2070 /* Create a window class */
2072 int local; /* is it a local class? */
2073 atom_t atom; /* class atom */
2074 unsigned int style; /* class style */
2075 void* instance; /* module instance */
2076 int extra; /* number of extra class bytes */
2077 int win_extra; /* number of window extra bytes */
2078 void* client_ptr; /* pointer to class in client address space */
2082 /* Destroy a window class */
2084 atom_t atom; /* class atom */
2085 void* instance; /* module instance */
2087 void* client_ptr; /* pointer to class in client address space */
2091 /* Set some information in a class */
2092 @REQ(set_class_info)
2093 user_handle_t window; /* handle to the window */
2094 unsigned int flags; /* flags for info to set (see below) */
2095 atom_t atom; /* class atom */
2096 unsigned int style; /* class style */
2097 int win_extra; /* number of window extra bytes */
2098 void* instance; /* module instance */
2099 int extra_offset; /* offset to set in extra bytes */
2100 size_t extra_size; /* size to set in extra bytes */
2101 unsigned int extra_value; /* value to set in extra bytes */
2103 atom_t old_atom; /* previous class atom */
2104 unsigned int old_style; /* previous class style */
2105 int old_extra; /* previous number of class extra bytes */
2106 int old_win_extra; /* previous number of window extra bytes */
2107 void* old_instance; /* previous module instance */
2108 unsigned int old_extra_value; /* old value in extra bytes */
2110 #define SET_CLASS_ATOM 0x0001
2111 #define SET_CLASS_STYLE 0x0002
2112 #define SET_CLASS_WINEXTRA 0x0004
2113 #define SET_CLASS_INSTANCE 0x0008
2114 #define SET_CLASS_EXTRA 0x0010
2117 /* Set/get clipboard information */
2118 @REQ(set_clipboard_info)
2119 unsigned int flags; /* flags for fields to set (see below) */
2120 user_handle_t clipboard; /* clipboard window */
2121 user_handle_t owner; /* clipboard owner */
2122 user_handle_t viewer; /* first clipboard viewer */
2123 unsigned int seqno; /* change sequence number */
2125 unsigned int flags; /* status flags (see below) */
2126 user_handle_t old_clipboard; /* old clipboard window */
2127 user_handle_t old_owner; /* old clipboard owner */
2128 user_handle_t old_viewer; /* old clipboard viewer */
2129 unsigned int seqno; /* current sequence number */
2132 #define SET_CB_OPEN 0x001
2133 #define SET_CB_OWNER 0x002
2134 #define SET_CB_VIEWER 0x004
2135 #define SET_CB_SEQNO 0x008
2136 #define SET_CB_RELOWNER 0x010
2137 #define SET_CB_CLOSE 0x020
2138 #define CB_OPEN 0x040
2139 #define CB_OWNER 0x080
2142 /* Open a security token */
2144 obj_handle_t handle; /* handle to the thread or process */
2145 unsigned int flags; /* flags (see below) */
2147 obj_handle_t token; /* handle to the token */
2149 #define OPEN_TOKEN_THREAD 1
2150 #define OPEN_TOKEN_AS_SELF 2
2153 /* Set/get the global windows */
2154 @REQ(set_global_windows)
2155 unsigned int flags; /* flags for fields to set (see below) */
2156 user_handle_t shell_window; /* handle to the new shell window */
2157 user_handle_t shell_listview; /* handle to the new shell listview window */
2158 user_handle_t progman_window; /* handle to the new program manager window */
2159 user_handle_t taskman_window; /* handle to the new task manager window */
2161 user_handle_t old_shell_window; /* handle to the shell window */
2162 user_handle_t old_shell_listview; /* handle to the shell listview window */
2163 user_handle_t old_progman_window; /* handle to the new program manager window */
2164 user_handle_t old_taskman_window; /* handle to the new task manager window */
2166 #define SET_GLOBAL_SHELL_WINDOWS 0x01 /* set both main shell and listview windows */
2167 #define SET_GLOBAL_PROGMAN_WINDOW 0x02
2168 #define SET_GLOBAL_TASKMAN_WINDOW 0x04