git.oblomov.eu Git - wine/blob - server/protocol.def

   1 /* -*- C -*-
   2  *
   3  * Wine server protocol definition
   4  *
   5  * Copyright (C) 2001 Alexandre Julliard
   6  *
   7  * This file is used by tools/make_requests to build the
   8  * protocol structures in include/wine/server_protocol.h
   9  *
  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.
  14  *
  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.
  19  *
  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
  23  */
  24
  25 @HEADER  /* start of C declarations */
  26
  27 #include <stdarg.h>
  28 #include <stdlib.h>
  29 #include <time.h>
  30
  31 #include <windef.h>
  32 #include <winbase.h>
  33
  34 struct request_header
  35 {
  36     int          req;          /* request code */
  37     size_t       request_size; /* request variable part size */
  38     size_t       reply_size;   /* reply variable part maximum size */
  39 };
  40
  41 struct reply_header
  42 {
  43     unsigned int error;        /* error result */
  44     size_t       reply_size;   /* reply variable part size */
  45 };
  46
  47 /* placeholder structure for the maximum allowed request size */
  48 /* this is used to construct the generic_request union */
  49 struct request_max_size
  50 {
  51     int pad[16]; /* the max request size is 16 ints */
  52 };
  53
  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;
  59
  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 */
  62
  63
  64 /* definitions of the event data depending on the event code */
  65 struct debug_event_exception
  66 {
  67     EXCEPTION_RECORD record;   /* exception record */
  68     int              first;    /* first chance exception? */
  69 };
  70 struct debug_event_create_thread
  71 {
  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 */
  75 };
  76 struct debug_event_create_process
  77 {
  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? */
  88 };
  89 struct debug_event_exit
  90 {
  91     int          exit_code;  /* thread or process exit code */
  92 };
  93 struct debug_event_load_dll
  94 {
  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? */
 101 };
 102 struct debug_event_unload_dll
 103 {
 104     void       *base;       /* base address of the dll */
 105 };
 106 struct debug_event_output_string
 107 {
 108     void       *string;     /* string to display (in debugged process address space) */
 109     int         unicode;    /* is it Unicode? */
 110     int         length;     /* string length */
 111 };
 112 struct debug_event_rip_info
 113 {
 114     int         error;      /* ??? */
 115     int         type;       /* ??? */
 116 };
 117 union debug_event_data
 118 {
 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;
 127 };
 128
 129 /* debug event data */
 130 typedef struct
 131 {
 132     int                      code;   /* event code */
 133     union debug_event_data   info;   /* event information */
 134 } debug_event_t;
 135
 136 /* structure used in sending an fd from client to server */
 137 struct send_fd
 138 {
 139     thread_id_t tid;  /* thread id */
 140     int         fd;   /* file descriptor on client-side */
 141 };
 142
 143 /* structure sent by the server on the wait fifo */
 144 struct wake_up_reply
 145 {
 146     void *cookie;    /* magic cookie that was passed in select_request */
 147     int   signaled;  /* wait result */
 148 };
 149
 150 /* structure for absolute timeouts */
 151 typedef struct
 152 {
 153     int            sec;      /* seconds since Unix epoch */
 154     int            usec;     /* microseconds */
 155 } abs_time_t;
 156
 157 /* structure returned in the list of window properties */
 158 typedef struct
 159 {
 160     atom_t         atom;     /* property atom */
 161     short          string;   /* was atom a string originally? */
 162     obj_handle_t   handle;   /* handle stored in property */
 163 } property_data_t;
 164
 165 /* structure to specify window rectangles */
 166 typedef struct
 167 {
 168     int  left;
 169     int  top;
 170     int  right;
 171     int  bottom;
 172 } rectangle_t;
 173
 174 /* structure for console char/attribute info */
 175 typedef struct
 176 {
 177     WCHAR          ch;
 178     unsigned short attr;
 179 } char_info_t;
 180
 181 #define MAX_ACL_LEN 65535
 182
 183 struct security_descriptor
 184 {
 185     unsigned int control;       /* SE_ flags */
 186     size_t owner_len;
 187     size_t group_len;
 188     size_t sacl_len;
 189     size_t dacl_len;
 190     /* VARARGS(owner,SID); */
 191     /* VARARGS(group,SID); */
 192     /* VARARGS(sacl,ACL); */
 193     /* VARARGS(dacl,ACL); */
 194 };
 195
 196 /****************************************************************/
 197 /* Request declarations */
 198
 199 /* Create a new process from the context of the parent */
 200 @REQ(new_process)
 201     int          inherit_all;  /* inherit all handles from parent */
 202     unsigned int create_flags; /* creation flags */
 203     int          unix_pid;     /* Unix pid of new process */
 204     obj_handle_t exe_file;     /* file handle for main exe */
 205     obj_handle_t hstdin;       /* handle for stdin */
 206     obj_handle_t hstdout;      /* handle for stdout */
 207     obj_handle_t hstderr;      /* handle for stderr */
 208     VARARG(info,startup_info); /* startup information */
 209     VARARG(env,unicode_str);   /* environment for new process */
 210 @REPLY
 211     obj_handle_t info;         /* new process info handle */
 212 @END
 213
 214
 215 /* Retrieve information about a newly started process */
 216 @REQ(get_new_process_info)
 217     obj_handle_t info;           /* info handle returned from new_process_request */
 218     unsigned int process_access; /* access rights for process object */
 219     unsigned int process_attr;   /* attributes for process object */
 220     unsigned int thread_access;  /* access rights for thread object */
 221     unsigned int thread_attr;    /* attributes for thread object */
 222 @REPLY
 223     process_id_t pid;          /* process id */
 224     obj_handle_t phandle;      /* process handle (in the current process) */
 225     thread_id_t  tid;          /* thread id */
 226     obj_handle_t thandle;      /* thread handle (in the current process) */
 227     int          success;      /* did the process start successfully? */
 228 @END
 229
 230
 231 /* Create a new thread from the context of the parent */
 232 @REQ(new_thread)
 233     unsigned int access;       /* wanted access rights */
 234     unsigned int attributes;   /* object attributes */
 235     int          suspend;      /* new thread should be suspended on creation */
 236     int          request_fd;   /* fd for request pipe */
 237 @REPLY
 238     thread_id_t  tid;          /* thread id */
 239     obj_handle_t handle;       /* thread handle (in the current process) */
 240 @END
 241
 242
 243 /* Retrieve the new process startup info */
 244 @REQ(get_startup_info)
 245 @REPLY
 246     obj_handle_t exe_file;     /* file handle for main exe */
 247     obj_handle_t hstdin;       /* handle for stdin */
 248     obj_handle_t hstdout;      /* handle for stdout */
 249     obj_handle_t hstderr;      /* handle for stderr */
 250     VARARG(info,startup_info); /* startup information */
 251     VARARG(env,unicode_str);   /* environment */
 252 @END
 253
 254
 255 /* Signal the end of the process initialization */
 256 @REQ(init_process_done)
 257     void*        module;       /* main module base address */
 258     void*        entry;        /* process entry point */
 259     int          gui;          /* is it a GUI process? */
 260 @END
 261
 262
 263 /* Initialize a thread; called from the child after fork()/clone() */
 264 @REQ(init_thread)
 265     int          unix_pid;     /* Unix pid of new thread */
 266     int          unix_tid;     /* Unix tid of new thread */
 267     void*        teb;          /* TEB of new thread (in thread address space) */
 268     void*        peb;          /* address of PEB (in thread address space) */
 269     void*        entry;        /* thread entry point (in thread address space) */
 270     void*        ldt_copy;     /* address of LDT copy (in thread address space) */
 271     int          reply_fd;     /* fd for reply pipe */
 272     int          wait_fd;      /* fd for blocking calls pipe */
 273     int          debug_level;  /* new debug level */
 274 @REPLY
 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     size_t       info_size;    /* total size of startup info */
 278     time_t       server_start; /* server start time */
 279     int          version;      /* protocol version */
 280 @END
 281
 282
 283 /* Terminate a process */
 284 @REQ(terminate_process)
 285     obj_handle_t handle;       /* process handle to terminate */
 286     int          exit_code;    /* process exit code */
 287 @REPLY
 288     int          self;         /* suicide? */
 289 @END
 290
 291
 292 /* Terminate a thread */
 293 @REQ(terminate_thread)
 294     obj_handle_t handle;       /* thread handle to terminate */
 295     int          exit_code;    /* thread exit code */
 296 @REPLY
 297     int          self;         /* suicide? */
 298     int          last;         /* last thread in this process? */
 299 @END
 300
 301
 302 /* Retrieve information about a process */
 303 @REQ(get_process_info)
 304     obj_handle_t handle;           /* process handle */
 305 @REPLY
 306     process_id_t pid;              /* server process id */
 307     process_id_t ppid;             /* server process id of parent */
 308     int          exit_code;        /* process exit code */
 309     int          priority;         /* priority class */
 310     int          affinity;         /* process affinity mask */
 311     void*        peb;              /* PEB address in process address space */
 312 @END
 313
 314
 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 */
 321 @END
 322 #define SET_PROCESS_INFO_PRIORITY 0x01
 323 #define SET_PROCESS_INFO_AFFINITY 0x02
 324
 325
 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) */
 330 @REPLY
 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 */
 339 @END
 340
 341
 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 */
 348     obj_handle_t token;        /* impersonation token */
 349 @END
 350 #define SET_THREAD_INFO_PRIORITY 0x01
 351 #define SET_THREAD_INFO_AFFINITY 0x02
 352 #define SET_THREAD_INFO_TOKEN    0x04
 353
 354
 355 /* Retrieve information about a module */
 356 @REQ(get_dll_info)
 357     obj_handle_t handle;       /* process handle */
 358     void*        base_address; /* base address of module */
 359 @REPLY
 360     size_t       size;          /* module size */
 361     void*        entry_point;
 362     VARARG(filename,unicode_str); /* file name of module */
 363 @END
 364
 365
 366 /* Suspend a thread */
 367 @REQ(suspend_thread)
 368     obj_handle_t handle;       /* thread handle */
 369 @REPLY
 370     int          count;        /* new suspend count */
 371 @END
 372
 373
 374 /* Resume a thread */
 375 @REQ(resume_thread)
 376     obj_handle_t handle;       /* thread handle */
 377 @REPLY
 378     int          count;        /* new suspend count */
 379 @END
 380
 381
 382 /* Notify the server that a dll has been loaded */
 383 @REQ(load_dll)
 384     obj_handle_t handle;       /* file handle */
 385     void*        base;         /* base address */
 386     size_t       size;         /* dll size */
 387     int          dbg_offset;   /* debug info offset */
 388     int          dbg_size;     /* debug info size */
 389     void*        name;         /* ptr to ptr to name (in process addr space) */
 390     VARARG(filename,unicode_str); /* file name of dll */
 391 @END
 392
 393
 394 /* Notify the server that a dll is being unloaded */
 395 @REQ(unload_dll)
 396     void*        base;         /* base address */
 397 @END
 398
 399
 400 /* Queue an APC for a thread */
 401 @REQ(queue_apc)
 402     obj_handle_t handle;       /* thread handle */
 403     int          user;         /* user or system apc? */
 404     void*        func;         /* function to call */
 405     void*        arg1;         /* params for function to call */
 406     void*        arg2;
 407     void*        arg3;
 408 @END
 409
 410
 411 /* Get next APC to call */
 412 @REQ(get_apc)
 413     int          alertable;    /* is thread alertable? */
 414 @REPLY
 415     void*        func;         /* function to call */
 416     int          type;         /* function type */
 417     void*        arg1;         /* function arguments */
 418     void*        arg2;
 419     void*        arg3;
 420 @END
 421 enum apc_type { APC_NONE, APC_USER, APC_TIMER, APC_ASYNC_IO };
 422
 423
 424 /* Close a handle for the current process */
 425 @REQ(close_handle)
 426     obj_handle_t handle;       /* handle to close */
 427 @REPLY
 428     int          fd;           /* associated fd to close */
 429 @END
 430
 431
 432 /* Set a handle information */
 433 @REQ(set_handle_info)
 434     obj_handle_t handle;       /* handle we are interested in */
 435     int          flags;        /* new handle flags */
 436     int          mask;         /* mask for flags to set */
 437 @REPLY
 438     int          old_flags;    /* old flag value */
 439 @END
 440
 441
 442 /* Duplicate a handle */
 443 @REQ(dup_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     unsigned int attributes;   /* object attributes */
 449     unsigned int options;      /* duplicate options (see below) */
 450 @REPLY
 451     obj_handle_t handle;       /* duplicated handle in dst process */
 452     int          fd;           /* associated fd to close */
 453 @END
 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 */
 457
 458
 459 /* Open a handle to a process */
 460 @REQ(open_process)
 461     process_id_t pid;          /* process id to open */
 462     unsigned int access;       /* wanted access rights */
 463     unsigned int attributes;   /* object attributes */
 464 @REPLY
 465     obj_handle_t handle;       /* handle to the process */
 466 @END
 467
 468
 469 /* Open a handle to a thread */
 470 @REQ(open_thread)
 471     thread_id_t  tid;          /* thread id to open */
 472     unsigned int access;       /* wanted access rights */
 473     unsigned int attributes;   /* object attributes */
 474 @REPLY
 475     obj_handle_t handle;       /* handle to the thread */
 476 @END
 477
 478
 479 /* Wait for handles */
 480 @REQ(select)
 481     int          flags;        /* wait flags (see below) */
 482     void*        cookie;       /* magic cookie to return to client */
 483     obj_handle_t signal;       /* object to signal (0 if none) */
 484     abs_time_t   timeout;      /* absolute timeout */
 485     VARARG(handles,handles);   /* handles to select on */
 486 @END
 487 #define SELECT_ALL           1
 488 #define SELECT_ALERTABLE     2
 489 #define SELECT_INTERRUPTIBLE 4
 490 #define SELECT_TIMEOUT       8
 491
 492
 493 /* Create an event */
 494 @REQ(create_event)
 495     unsigned int access;        /* wanted access rights */
 496     unsigned int attributes;    /* object attributes */
 497     obj_handle_t rootdir;       /* root directory */
 498     int          manual_reset;  /* manual reset event */
 499     int          initial_state; /* initial state of the event */
 500     VARARG(name,unicode_str);   /* object name */
 501 @REPLY
 502     obj_handle_t handle;        /* handle to the event */
 503 @END
 504
 505 /* Event operation */
 506 @REQ(event_op)
 507     obj_handle_t  handle;       /* handle to event */
 508     int           op;           /* event operation (see below) */
 509 @END
 510 enum event_op { PULSE_EVENT, SET_EVENT, RESET_EVENT };
 511
 512
 513 /* Open an event */
 514 @REQ(open_event)
 515     unsigned int access;        /* wanted access rights */
 516     unsigned int attributes;    /* object attributes */
 517     obj_handle_t rootdir;       /* root directory */
 518     VARARG(name,unicode_str);   /* object name */
 519 @REPLY
 520     obj_handle_t handle;        /* handle to the event */
 521 @END
 522
 523
 524 /* Create a mutex */
 525 @REQ(create_mutex)
 526     unsigned int access;        /* wanted access rights */
 527     unsigned int attributes;    /* object attributes */
 528     obj_handle_t rootdir;       /* root directory */
 529     int          owned;         /* initially owned? */
 530     VARARG(name,unicode_str);   /* object name */
 531 @REPLY
 532     obj_handle_t handle;        /* handle to the mutex */
 533 @END
 534
 535
 536 /* Release a mutex */
 537 @REQ(release_mutex)
 538     obj_handle_t handle;        /* handle to the mutex */
 539 @REPLY
 540     unsigned int prev_count;    /* value of internal counter, before release */
 541 @END
 542
 543
 544 /* Open a mutex */
 545 @REQ(open_mutex)
 546     unsigned int access;        /* wanted access rights */
 547     unsigned int attributes;    /* object attributes */
 548     obj_handle_t rootdir;       /* root directory */
 549     VARARG(name,unicode_str);   /* object name */
 550 @REPLY
 551     obj_handle_t handle;        /* handle to the mutex */
 552 @END
 553
 554
 555 /* Create a semaphore */
 556 @REQ(create_semaphore)
 557     unsigned int access;        /* wanted access rights */
 558     unsigned int attributes;    /* object attributes */
 559     obj_handle_t rootdir;       /* root directory */
 560     unsigned int initial;       /* initial count */
 561     unsigned int max;           /* maximum count */
 562     VARARG(name,unicode_str);   /* object name */
 563 @REPLY
 564     obj_handle_t handle;        /* handle to the semaphore */
 565 @END
 566
 567
 568 /* Release a semaphore */
 569 @REQ(release_semaphore)
 570     obj_handle_t handle;        /* handle to the semaphore */
 571     unsigned int count;         /* count to add to semaphore */
 572 @REPLY
 573     unsigned int prev_count;    /* previous semaphore count */
 574 @END
 575
 576
 577 /* Open a semaphore */
 578 @REQ(open_semaphore)
 579     unsigned int access;        /* wanted access rights */
 580     unsigned int attributes;    /* object attributes */
 581     obj_handle_t rootdir;       /* root directory */
 582     VARARG(name,unicode_str);   /* object name */
 583 @REPLY
 584     obj_handle_t handle;        /* handle to the semaphore */
 585 @END
 586
 587
 588 /* Create a file */
 589 @REQ(create_file)
 590     unsigned int access;        /* wanted access rights */
 591     unsigned int attributes;    /* object attributes */
 592     unsigned int sharing;       /* sharing flags */
 593     int          create;        /* file create action */
 594     unsigned int options;       /* file options */
 595     unsigned int attrs;         /* file attributes for creation */
 596     VARARG(filename,string);    /* file name */
 597 @REPLY
 598     obj_handle_t handle;        /* handle to the file */
 599 @END
 600
 601
 602 /* Open a file object */
 603 @REQ(open_file_object)
 604     unsigned int access;        /* wanted access rights */
 605     unsigned int attributes;    /* open attributes */
 606     obj_handle_t rootdir;       /* root directory */
 607     unsigned int sharing;       /* sharing flags */
 608     VARARG(filename,unicode_str); /* file name */
 609 @REPLY
 610     obj_handle_t handle;        /* handle to the file */
 611 @END
 612
 613
 614 /* Allocate a file handle for a Unix fd */
 615 @REQ(alloc_file_handle)
 616     unsigned int access;        /* wanted access rights */
 617     unsigned int attributes;    /* object attributes */
 618     int          fd;            /* file descriptor on the client side */
 619 @REPLY
 620     obj_handle_t handle;        /* handle to the file */
 621 @END
 622
 623
 624 /* Get a Unix fd to access a file */
 625 @REQ(get_handle_fd)
 626     obj_handle_t handle;        /* handle to the file */
 627     unsigned int access;        /* wanted access rights */
 628 @REPLY
 629     int          fd;            /* file descriptor */
 630     int          removable;     /* is device removable? (-1 if unknown) */
 631     int          flags;         /* file read/write flags (see below) */
 632 @END
 633 #define FD_FLAG_OVERLAPPED         0x01 /* fd opened in overlapped mode */
 634 #define FD_FLAG_TIMEOUT            0x02 /* read/write is synchronous */
 635 #define FD_FLAG_RECV_SHUTDOWN      0x04
 636 #define FD_FLAG_SEND_SHUTDOWN      0x08
 637 #define FD_FLAG_AVAILABLE          0x10 /* in overlap read/write operation,
 638                                          * only handle available data (don't wait) */
 639
 640 /* Set the cached file descriptor of a handle */
 641 @REQ(set_handle_fd)
 642     obj_handle_t handle;       /* handle we are interested in */
 643     int          fd;           /* file descriptor */
 644     int          removable;    /* is device removable? (-1 if unknown) */
 645 @REPLY
 646     int          cur_fd;       /* current file descriptor */
 647 @END
 648
 649
 650 /* Flush a file buffers */
 651 @REQ(flush_file)
 652     obj_handle_t handle;        /* handle to the file */
 653 @REPLY
 654     obj_handle_t event;         /* event set when finished */
 655 @END
 656
 657
 658 /* Lock a region of a file */
 659 @REQ(lock_file)
 660     obj_handle_t handle;        /* handle to the file */
 661     unsigned int offset_low;    /* offset of start of lock */
 662     unsigned int offset_high;   /* offset of start of lock */
 663     unsigned int count_low;     /* count of bytes to lock */
 664     unsigned int count_high;    /* count of bytes to lock */
 665     int          shared;        /* shared or exclusive lock? */
 666     int          wait;          /* do we want to wait? */
 667 @REPLY
 668     obj_handle_t handle;        /* handle to wait on */
 669     int          overlapped;    /* is it an overlapped I/O handle? */
 670 @END
 671
 672
 673 /* Unlock a region of a file */
 674 @REQ(unlock_file)
 675     obj_handle_t handle;        /* handle to the file */
 676     unsigned int offset_low;    /* offset of start of unlock */
 677     unsigned int offset_high;   /* offset of start of unlock */
 678     unsigned int count_low;     /* count of bytes to unlock */
 679     unsigned int count_high;    /* count of bytes to unlock */
 680 @END
 681
 682
 683 /* Get ready to unmount a Unix device */
 684 @REQ(unmount_device)
 685     obj_handle_t handle;        /* handle to a file on the device */
 686 @END
 687
 688
 689 /* Create a socket */
 690 @REQ(create_socket)
 691     unsigned int access;        /* wanted access rights */
 692     unsigned int attributes;    /* object attributes */
 693     int          family;        /* family, see socket manpage */
 694     int          type;          /* type, see socket manpage */
 695     int          protocol;      /* protocol, see socket manpage */
 696     unsigned int flags;         /* socket flags */
 697 @REPLY
 698     obj_handle_t handle;        /* handle to the new socket */
 699 @END
 700
 701
 702 /* Accept a socket */
 703 @REQ(accept_socket)
 704     obj_handle_t lhandle;       /* handle to the listening socket */
 705     unsigned int access;        /* wanted access rights */
 706     unsigned int attributes;    /* object attributes */
 707 @REPLY
 708     obj_handle_t handle;        /* handle to the new socket */
 709 @END
 710
 711
 712 /* Set socket event parameters */
 713 @REQ(set_socket_event)
 714     obj_handle_t  handle;        /* handle to the socket */
 715     unsigned int  mask;          /* event mask */
 716     obj_handle_t  event;         /* event object */
 717     user_handle_t window;        /* window to send the message to */
 718     unsigned int  msg;           /* message to send */
 719 @END
 720
 721
 722 /* Get socket event parameters */
 723 @REQ(get_socket_event)
 724     obj_handle_t handle;        /* handle to the socket */
 725     int          service;       /* clear pending? */
 726     obj_handle_t c_event;       /* event to clear */
 727 @REPLY
 728     unsigned int mask;          /* event mask */
 729     unsigned int pmask;         /* pending events */
 730     unsigned int state;         /* status bits */
 731     VARARG(errors,ints);        /* event errors */
 732 @END
 733
 734
 735 /* Reenable pending socket events */
 736 @REQ(enable_socket_event)
 737     obj_handle_t handle;        /* handle to the socket */
 738     unsigned int mask;          /* events to re-enable */
 739     unsigned int sstate;        /* status bits to set */
 740     unsigned int cstate;        /* status bits to clear */
 741 @END
 742
 743 @REQ(set_socket_deferred)
 744     obj_handle_t handle;        /* handle to the socket */
 745     obj_handle_t deferred;      /* handle to the socket for which accept() is deferred */
 746 @END
 747
 748 /* Allocate a console (only used by a console renderer) */
 749 @REQ(alloc_console)
 750     unsigned int access;        /* wanted access rights */
 751     unsigned int attributes;    /* object attributes */
 752     process_id_t pid;           /* pid of process which shall be attached to the console */
 753 @REPLY
 754     obj_handle_t handle_in;     /* handle to console input */
 755     obj_handle_t event;         /* handle to renderer events change notification */
 756 @END
 757
 758
 759 /* Free the console of the current process */
 760 @REQ(free_console)
 761 @END
 762
 763
 764 #define CONSOLE_RENDERER_NONE_EVENT        0x00
 765 #define CONSOLE_RENDERER_TITLE_EVENT       0x01
 766 #define CONSOLE_RENDERER_ACTIVE_SB_EVENT   0x02
 767 #define CONSOLE_RENDERER_SB_RESIZE_EVENT   0x03
 768 #define CONSOLE_RENDERER_UPDATE_EVENT      0x04
 769 #define CONSOLE_RENDERER_CURSOR_POS_EVENT  0x05
 770 #define CONSOLE_RENDERER_CURSOR_GEOM_EVENT 0x06
 771 #define CONSOLE_RENDERER_DISPLAY_EVENT     0x07
 772 #define CONSOLE_RENDERER_EXIT_EVENT        0x08
 773 struct console_renderer_event
 774 {
 775     short event;
 776     union
 777     {
 778         struct update
 779         {
 780             short top;
 781             short bottom;
 782         } update;
 783         struct resize
 784         {
 785             short width;
 786             short height;
 787         } resize;
 788         struct cursor_pos
 789         {
 790             short x;
 791             short y;
 792         } cursor_pos;
 793         struct cursor_geom
 794         {
 795             short visible;
 796             short size;
 797         } cursor_geom;
 798         struct display
 799         {
 800             short left;
 801             short top;
 802             short width;
 803             short height;
 804         } display;
 805     } u;
 806 };
 807
 808 /* retrieve console events for the renderer */
 809 @REQ(get_console_renderer_events)
 810     obj_handle_t handle;        /* handle to console input events */
 811 @REPLY
 812     VARARG(data,bytes);         /* the various console_renderer_events */
 813 @END
 814
 815
 816 /* Open a handle to the process console */
 817 @REQ(open_console)
 818     int          from;          /* 0 (resp 1) input (resp output) of current process console */
 819                                 /* otherwise console_in handle to get active screen buffer? */
 820     unsigned int access;        /* wanted access rights */
 821     unsigned int attributes;    /* object attributes */
 822     int          share;         /* share mask (only for output handles) */
 823 @REPLY
 824     obj_handle_t handle;        /* handle to the console */
 825 @END
 826
 827
 828 /* Get the input queue wait event */
 829 @REQ(get_console_wait_event)
 830 @REPLY
 831     obj_handle_t handle;
 832 @END
 833
 834 /* Get a console mode (input or output) */
 835 @REQ(get_console_mode)
 836     obj_handle_t handle;        /* handle to the console */
 837 @REPLY
 838     int          mode;          /* console mode */
 839 @END
 840
 841
 842 /* Set a console mode (input or output) */
 843 @REQ(set_console_mode)
 844     obj_handle_t handle;        /* handle to the console */
 845     int          mode;          /* console mode */
 846 @END
 847
 848
 849 /* Set info about a console (input only) */
 850 @REQ(set_console_input_info)
 851     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
 852     int          mask;          /* setting mask (see below) */
 853     obj_handle_t active_sb;     /* active screen buffer */
 854     int          history_mode;  /* whether we duplicate lines in history */
 855     int          history_size;  /* number of lines in history */
 856     int          edition_mode;  /* index to the edition mode flavors */
 857     VARARG(title,unicode_str);  /* console title */
 858 @END
 859 #define SET_CONSOLE_INPUT_INFO_ACTIVE_SB        0x01
 860 #define SET_CONSOLE_INPUT_INFO_TITLE            0x02
 861 #define SET_CONSOLE_INPUT_INFO_HISTORY_MODE     0x04
 862 #define SET_CONSOLE_INPUT_INFO_HISTORY_SIZE     0x08
 863 #define SET_CONSOLE_INPUT_INFO_EDITION_MODE     0x10
 864
 865
 866 /* Get info about a console (input only) */
 867 @REQ(get_console_input_info)
 868     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
 869 @REPLY
 870     int          history_mode;  /* whether we duplicate lines in history */
 871     int          history_size;  /* number of lines in history */
 872     int          history_index; /* number of used lines in history */
 873     int          edition_mode;  /* index to the edition mode flavors */
 874     VARARG(title,unicode_str);  /* console title */
 875 @END
 876
 877
 878 /* appends a string to console's history */
 879 @REQ(append_console_input_history)
 880     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
 881     VARARG(line,unicode_str);   /* line to add */
 882 @END
 883
 884
 885 /* appends a string to console's history */
 886 @REQ(get_console_input_history)
 887     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
 888     int          index;         /* index to get line from */
 889 @REPLY
 890     int          total;         /* total length of line in Unicode chars */
 891     VARARG(line,unicode_str);   /* line to add */
 892 @END
 893
 894
 895 /* creates a new screen buffer on process' console */
 896 @REQ(create_console_output)
 897     obj_handle_t handle_in;     /* handle to console input, or 0 for process' console */
 898     unsigned int access;        /* wanted access rights */
 899     unsigned int attributes;    /* object attributes */
 900     unsigned int share;         /* sharing credentials */
 901 @REPLY
 902     obj_handle_t handle_out;    /* handle to the screen buffer */
 903 @END
 904
 905
 906 /* Set info about a console (output only) */
 907 @REQ(set_console_output_info)
 908     obj_handle_t handle;        /* handle to the console */
 909     int          mask;          /* setting mask (see below) */
 910     short int    cursor_size;   /* size of cursor (percentage filled) */
 911     short int    cursor_visible;/* cursor visibility flag */
 912     short int    cursor_x;      /* position of cursor (x, y) */
 913     short int    cursor_y;
 914     short int    width;         /* width of the screen buffer */
 915     short int    height;        /* height of the screen buffer */
 916     short int    attr;          /* default attribute */
 917     short int    win_left;      /* window actually displayed by renderer */
 918     short int    win_top;       /* the rect area is expressed withing the */
 919     short int    win_right;     /* boundaries of the screen buffer */
 920     short int    win_bottom;
 921     short int    max_width;     /* maximum size (width x height) for the window */
 922     short int    max_height;
 923 @END
 924 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_GEOM     0x01
 925 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_POS      0x02
 926 #define SET_CONSOLE_OUTPUT_INFO_SIZE            0x04
 927 #define SET_CONSOLE_OUTPUT_INFO_ATTR            0x08
 928 #define SET_CONSOLE_OUTPUT_INFO_DISPLAY_WINDOW  0x10
 929 #define SET_CONSOLE_OUTPUT_INFO_MAX_SIZE        0x20
 930
 931
 932 /* Get info about a console (output only) */
 933 @REQ(get_console_output_info)
 934     obj_handle_t handle;        /* handle to the console */
 935 @REPLY
 936     short int    cursor_size;   /* size of cursor (percentage filled) */
 937     short int    cursor_visible;/* cursor visibility flag */
 938     short int    cursor_x;      /* position of cursor (x, y) */
 939     short int    cursor_y;
 940     short int    width;         /* width of the screen buffer */
 941     short int    height;        /* height of the screen buffer */
 942     short int    attr;          /* default attribute */
 943     short int    win_left;      /* window actually displayed by renderer */
 944     short int    win_top;       /* the rect area is expressed withing the */
 945     short int    win_right;     /* boundaries of the screen buffer */
 946     short int    win_bottom;
 947     short int    max_width;     /* maximum size (width x height) for the window */
 948     short int    max_height;
 949 @END
 950
 951 /* Add input records to a console input queue */
 952 @REQ(write_console_input)
 953     obj_handle_t handle;        /* handle to the console input */
 954     VARARG(rec,input_records);  /* input records */
 955 @REPLY
 956     int          written;       /* number of records written */
 957 @END
 958
 959
 960 /* Fetch input records from a console input queue */
 961 @REQ(read_console_input)
 962     obj_handle_t handle;        /* handle to the console input */
 963     int          flush;         /* flush the retrieved records from the queue? */
 964 @REPLY
 965     int          read;          /* number of records read */
 966     VARARG(rec,input_records);  /* input records */
 967 @END
 968
 969
 970 /* write data (chars and/or attributes) in a screen buffer */
 971 @REQ(write_console_output)
 972     obj_handle_t handle;        /* handle to the console output */
 973     int          x;             /* position where to start writing */
 974     int          y;
 975     int          mode;          /* char info (see below) */
 976     int          wrap;          /* wrap around at end of line? */
 977     VARARG(data,bytes);         /* info to write */
 978 @REPLY
 979     int          written;       /* number of char infos actually written */
 980     int          width;         /* width of screen buffer */
 981     int          height;        /* height of screen buffer */
 982 @END
 983 enum char_info_mode
 984 {
 985     CHAR_INFO_MODE_TEXT,        /* characters only */
 986     CHAR_INFO_MODE_ATTR,        /* attributes only */
 987     CHAR_INFO_MODE_TEXTATTR,    /* both characters and attributes */
 988     CHAR_INFO_MODE_TEXTSTDATTR  /* characters but use standard attributes */
 989 };
 990
 991
 992 /* fill a screen buffer with constant data (chars and/or attributes) */
 993 @REQ(fill_console_output)
 994     obj_handle_t handle;        /* handle to the console output */
 995     int          x;             /* position where to start writing */
 996     int          y;
 997     int          mode;          /* char info mode */
 998     int          count;         /* number to write */
 999     int          wrap;          /* wrap around at end of line? */
1000     char_info_t  data;          /* data to write */
1001 @REPLY
1002     int          written;       /* number of char infos actually written */
1003 @END
1004
1005
1006 /* read data (chars and/or attributes) from a screen buffer */
1007 @REQ(read_console_output)
1008     obj_handle_t handle;        /* handle to the console output */
1009     int          x;             /* position (x,y) where to start reading */
1010     int          y;
1011     int          mode;          /* char info mode */
1012     int          wrap;          /* wrap around at end of line? */
1013 @REPLY
1014     int          width;         /* width of screen buffer */
1015     int          height;        /* height of screen buffer */
1016     VARARG(data,bytes);
1017 @END
1018
1019
1020 /* move a rect (of data) in screen buffer content */
1021 @REQ(move_console_output)
1022     obj_handle_t handle;        /* handle to the console output */
1023     short int    x_src;         /* position (x, y) of rect to start moving from */
1024     short int    y_src;
1025     short int    x_dst;         /* position (x, y) of rect to move to */
1026     short int    y_dst;
1027     short int    w;             /* size of the rect (width, height) to move */
1028     short int    h;
1029 @END
1030
1031
1032 /* Sends a signal to a process group */
1033 @REQ(send_console_signal)
1034     int          signal;        /* the signal to send */
1035     process_id_t group_id;      /* the group to send the signal to */
1036 @END
1037
1038
1039 /* enable directory change notifications */
1040 @REQ(read_directory_changes)
1041     obj_handle_t handle;        /* handle to the directory */
1042     obj_handle_t event;         /* handle to the event */
1043     unsigned int filter;        /* notification filter */
1044     int          subtree;       /* watch the subtree? */
1045     int          want_data;     /* flag indicating whether change data should be collected */
1046     void*        io_apc;        /* APC routine to queue upon end of async */
1047     void*        io_sb;         /* I/O status block (unique across all async on this handle) */
1048     void*        io_user;       /* data to pass back to caller */
1049 @END
1050
1051
1052 @REQ(read_change)
1053     obj_handle_t handle;
1054 @REPLY
1055     int          action;        /* type of change */
1056     VARARG(name,string);        /* name of directory entry that changed */
1057 @END
1058
1059
1060 /* Create a file mapping */
1061 @REQ(create_mapping)
1062     unsigned int access;        /* wanted access rights */
1063     unsigned int attributes;    /* object attributes */
1064     obj_handle_t rootdir;       /* root directory */
1065     int          size_high;     /* mapping size */
1066     int          size_low;      /* mapping size */
1067     int          protect;       /* protection flags (see below) */
1068     obj_handle_t file_handle;   /* file handle */
1069     VARARG(name,unicode_str);   /* object name */
1070 @REPLY
1071     obj_handle_t handle;        /* handle to the mapping */
1072 @END
1073 /* protection flags */
1074 #define VPROT_READ       0x01
1075 #define VPROT_WRITE      0x02
1076 #define VPROT_EXEC       0x04
1077 #define VPROT_WRITECOPY  0x08
1078 #define VPROT_GUARD      0x10
1079 #define VPROT_NOCACHE    0x20
1080 #define VPROT_COMMITTED  0x40
1081 #define VPROT_IMAGE      0x80
1082
1083
1084 /* Open a mapping */
1085 @REQ(open_mapping)
1086     unsigned int access;        /* wanted access rights */
1087     unsigned int attributes;    /* object attributes */
1088     obj_handle_t rootdir;       /* root directory */
1089     VARARG(name,unicode_str);   /* object name */
1090 @REPLY
1091     obj_handle_t handle;        /* handle to the mapping */
1092 @END
1093
1094
1095 /* Get information about a file mapping */
1096 @REQ(get_mapping_info)
1097     obj_handle_t handle;        /* handle to the mapping */
1098 @REPLY
1099     int          size_high;     /* mapping size */
1100     int          size_low;      /* mapping size */
1101     int          protect;       /* protection flags */
1102     int          header_size;   /* header size (for VPROT_IMAGE mapping) */
1103     void*        base;          /* default base addr (for VPROT_IMAGE mapping) */
1104     obj_handle_t shared_file;   /* shared mapping file handle */
1105     int          shared_size;   /* shared mapping size */
1106 @END
1107
1108
1109 #define SNAP_HEAPLIST   0x00000001
1110 #define SNAP_PROCESS    0x00000002
1111 #define SNAP_THREAD     0x00000004
1112 #define SNAP_MODULE     0x00000008
1113 /* Create a snapshot */
1114 @REQ(create_snapshot)
1115     unsigned int attributes;    /* object attributes */
1116     int          flags;         /* snapshot flags (SNAP_*) */
1117     process_id_t pid;           /* process id */
1118 @REPLY
1119     obj_handle_t handle;        /* handle to the snapshot */
1120 @END
1121
1122
1123 /* Get the next process from a snapshot */
1124 @REQ(next_process)
1125     obj_handle_t handle;        /* handle to the snapshot */
1126     int          reset;         /* reset snapshot position? */
1127 @REPLY
1128     int          count;         /* process usage count */
1129     process_id_t pid;           /* process id */
1130     process_id_t ppid;          /* parent process id */
1131     void*        heap;          /* heap base */
1132     void*        module;        /* main module */
1133     int          threads;       /* number of threads */
1134     int          priority;      /* process priority */
1135     int          handles;       /* number of handles */
1136     VARARG(filename,unicode_str); /* file name of main exe */
1137 @END
1138
1139
1140 /* Get the next thread from a snapshot */
1141 @REQ(next_thread)
1142     obj_handle_t handle;        /* handle to the snapshot */
1143     int          reset;         /* reset snapshot position? */
1144 @REPLY
1145     int          count;         /* thread usage count */
1146     process_id_t pid;           /* process id */
1147     thread_id_t  tid;           /* thread id */
1148     int          base_pri;      /* base priority */
1149     int          delta_pri;     /* delta priority */
1150 @END
1151
1152
1153 /* Get the next module from a snapshot */
1154 @REQ(next_module)
1155     obj_handle_t handle;        /* handle to the snapshot */
1156     int          reset;         /* reset snapshot position? */
1157 @REPLY
1158     process_id_t pid;           /* process id */
1159     void*        base;          /* module base address */
1160     size_t       size;          /* module size */
1161     VARARG(filename,unicode_str); /* file name of module */
1162 @END
1163
1164
1165 /* Wait for a debug event */
1166 @REQ(wait_debug_event)
1167     int           get_handle;  /* should we alloc a handle for waiting? */
1168 @REPLY
1169     process_id_t  pid;         /* process id */
1170     thread_id_t   tid;         /* thread id */
1171     obj_handle_t  wait;        /* wait handle if no event ready */
1172     VARARG(event,debug_event); /* debug event data */
1173 @END
1174
1175
1176 /* Queue an exception event */
1177 @REQ(queue_exception_event)
1178     int              first;    /* first chance exception? */
1179     VARARG(record,exc_event);  /* thread context followed by exception record */
1180 @REPLY
1181     obj_handle_t     handle;   /* handle to the queued event */
1182 @END
1183
1184
1185 /* Retrieve the status of an exception event */
1186 @REQ(get_exception_status)
1187     obj_handle_t     handle;   /* handle to the queued event */
1188 @REPLY
1189     VARARG(context,context);   /* modified thread context */
1190 @END
1191
1192
1193 /* Send an output string to the debugger */
1194 @REQ(output_debug_string)
1195     void*         string;      /* string to display (in debugged process address space) */
1196     int           unicode;     /* is it Unicode? */
1197     int           length;      /* string length */
1198 @END
1199
1200
1201 /* Continue a debug event */
1202 @REQ(continue_debug_event)
1203     process_id_t pid;          /* process id to continue */
1204     thread_id_t  tid;          /* thread id to continue */
1205     int          status;       /* continuation status */
1206 @END
1207
1208
1209 /* Start/stop debugging an existing process */
1210 @REQ(debug_process)
1211     process_id_t pid;          /* id of the process to debug */
1212     int          attach;       /* 1=attaching / 0=detaching from the process */
1213 @END
1214
1215
1216 /* Simulate a breakpoint in a process */
1217 @REQ(debug_break)
1218     obj_handle_t handle;       /* process handle */
1219 @REPLY
1220     int          self;         /* was it the caller itself? */
1221 @END
1222
1223
1224 /* Set debugger kill on exit flag */
1225 @REQ(set_debugger_kill_on_exit)
1226     int          kill_on_exit;  /* 0=detach/1=kill debuggee when debugger dies */
1227 @END
1228
1229
1230 /* Read data from a process address space */
1231 @REQ(read_process_memory)
1232     obj_handle_t handle;       /* process handle */
1233     void*        addr;         /* addr to read from */
1234 @REPLY
1235     VARARG(data,bytes);        /* result data */
1236 @END
1237
1238
1239 /* Write data to a process address space */
1240 @REQ(write_process_memory)
1241     obj_handle_t handle;       /* process handle */
1242     void*        addr;         /* addr to write to */
1243     VARARG(data,bytes);        /* data to write */
1244 @END
1245
1246
1247 /* Create a registry key */
1248 @REQ(create_key)
1249     obj_handle_t parent;       /* handle to the parent key */
1250     unsigned int access;       /* desired access rights */
1251     unsigned int attributes;   /* object attributes */
1252     unsigned int options;      /* creation options */
1253     time_t       modif;        /* last modification time */
1254     size_t       namelen;      /* length of key name in bytes */
1255     VARARG(name,unicode_str,namelen);  /* key name */
1256     VARARG(class,unicode_str);         /* class name */
1257 @REPLY
1258     obj_handle_t hkey;         /* handle to the created key */
1259     int          created;      /* has it been newly created? */
1260 @END
1261
1262 /* Open a registry key */
1263 @REQ(open_key)
1264     obj_handle_t parent;       /* handle to the parent key */
1265     unsigned int access;       /* desired access rights */
1266     unsigned int attributes;   /* object attributes */
1267     VARARG(name,unicode_str);  /* key name */
1268 @REPLY
1269     obj_handle_t hkey;         /* handle to the open key */
1270 @END
1271
1272
1273 /* Delete a registry key */
1274 @REQ(delete_key)
1275     obj_handle_t hkey;         /* handle to the key */
1276 @END
1277
1278
1279 /* Flush a registry key */
1280 @REQ(flush_key)
1281     obj_handle_t hkey;         /* handle to the key */
1282 @END
1283
1284
1285 /* Enumerate registry subkeys */
1286 @REQ(enum_key)
1287     obj_handle_t hkey;         /* handle to registry key */
1288     int          index;        /* index of subkey (or -1 for current key) */
1289     int          info_class;   /* requested information class */
1290 @REPLY
1291     int          subkeys;      /* number of subkeys */
1292     int          max_subkey;   /* longest subkey name */
1293     int          max_class;    /* longest class name */
1294     int          values;       /* number of values */
1295     int          max_value;    /* longest value name */
1296     int          max_data;     /* longest value data */
1297     time_t       modif;        /* last modification time */
1298     size_t       total;        /* total length needed for full name and class */
1299     size_t       namelen;      /* length of key name in bytes */
1300     VARARG(name,unicode_str,namelen);  /* key name */
1301     VARARG(class,unicode_str);         /* class name */
1302 @END
1303
1304
1305 /* Set a value of a registry key */
1306 @REQ(set_key_value)
1307     obj_handle_t hkey;         /* handle to registry key */
1308     int          type;         /* value type */
1309     size_t       namelen;      /* length of value name in bytes */
1310     VARARG(name,unicode_str,namelen);  /* value name */
1311     VARARG(data,bytes);                /* value data */
1312 @END
1313
1314
1315 /* Retrieve the value of a registry key */
1316 @REQ(get_key_value)
1317     obj_handle_t hkey;         /* handle to registry key */
1318     VARARG(name,unicode_str);  /* value name */
1319 @REPLY
1320     int          type;         /* value type */
1321     size_t       total;        /* total length needed for data */
1322     VARARG(data,bytes);        /* value data */
1323 @END
1324
1325
1326 /* Enumerate a value of a registry key */
1327 @REQ(enum_key_value)
1328     obj_handle_t hkey;         /* handle to registry key */
1329     int          index;        /* value index */
1330     int          info_class;   /* requested information class */
1331 @REPLY
1332     int          type;         /* value type */
1333     size_t       total;        /* total length needed for full name and data */
1334     size_t       namelen;      /* length of value name in bytes */
1335     VARARG(name,unicode_str,namelen);  /* value name */
1336     VARARG(data,bytes);                /* value data */
1337 @END
1338
1339
1340 /* Delete a value of a registry key */
1341 @REQ(delete_key_value)
1342     obj_handle_t hkey;         /* handle to registry key */
1343     VARARG(name,unicode_str);  /* value name */
1344 @END
1345
1346
1347 /* Load a registry branch from a file */
1348 @REQ(load_registry)
1349     obj_handle_t hkey;         /* root key to load to */
1350     obj_handle_t file;         /* file to load from */
1351     VARARG(name,unicode_str);  /* subkey name */
1352 @END
1353
1354
1355 /* UnLoad a registry branch from a file */
1356 @REQ(unload_registry)
1357     obj_handle_t hkey;         /* root key to unload to */
1358 @END
1359
1360
1361 /* Save a registry branch to a file */
1362 @REQ(save_registry)
1363     obj_handle_t hkey;         /* key to save */
1364     obj_handle_t file;         /* file to save to */
1365 @END
1366
1367
1368 /* Add a registry key change notification */
1369 @REQ(set_registry_notification)
1370     obj_handle_t hkey;         /* key to watch for changes */
1371     obj_handle_t event;        /* event to set */
1372     int          subtree;      /* should we watch the whole subtree? */
1373     unsigned int filter;       /* things to watch */
1374 @END
1375
1376
1377 /* Create a waitable timer */
1378 @REQ(create_timer)
1379     unsigned int access;        /* wanted access rights */
1380     unsigned int attributes;    /* object attributes */
1381     obj_handle_t rootdir;       /* root directory */
1382     int          manual;        /* manual reset */
1383     VARARG(name,unicode_str);   /* object name */
1384 @REPLY
1385     obj_handle_t handle;        /* handle to the timer */
1386 @END
1387
1388
1389 /* Open a waitable timer */
1390 @REQ(open_timer)
1391     unsigned int access;        /* wanted access rights */
1392     unsigned int attributes;    /* object attributes */
1393     obj_handle_t rootdir;       /* root directory */
1394     VARARG(name,unicode_str);   /* object name */
1395 @REPLY
1396     obj_handle_t handle;        /* handle to the timer */
1397 @END
1398
1399 /* Set a waitable timer */
1400 @REQ(set_timer)
1401     obj_handle_t handle;        /* handle to the timer */
1402     abs_time_t   expire;        /* next expiration absolute time */
1403     int          period;        /* timer period in ms */
1404     void*        callback;      /* callback function */
1405     void*        arg;           /* callback argument */
1406 @REPLY
1407     int          signaled;      /* was the timer signaled before this call ? */
1408 @END
1409
1410 /* Cancel a waitable timer */
1411 @REQ(cancel_timer)
1412     obj_handle_t handle;        /* handle to the timer */
1413 @REPLY
1414      int         signaled;      /* was the timer signaled before this calltime ? */
1415 @END
1416
1417 /* Get information on a waitable timer */
1418 @REQ(get_timer_info)
1419     obj_handle_t handle;        /* handle to the timer */
1420 @REPLY
1421     abs_time_t   when;          /* absolute time when the timer next expires */
1422     int          signaled;      /* is the timer signaled? */
1423 @END
1424
1425
1426 /* Retrieve the current context of a thread */
1427 @REQ(get_thread_context)
1428     obj_handle_t handle;       /* thread handle */
1429     unsigned int flags;        /* context flags */
1430     int          suspend;      /* if getting context during suspend */
1431 @REPLY
1432     int          self;         /* was it a handle to the current thread? */
1433     VARARG(context,context);   /* thread context */
1434 @END
1435
1436
1437 /* Set the current context of a thread */
1438 @REQ(set_thread_context)
1439     obj_handle_t handle;       /* thread handle */
1440     unsigned int flags;        /* context flags */
1441     int          suspend;      /* if setting context during suspend */
1442     VARARG(context,context);   /* thread context */
1443 @REPLY
1444     int          self;         /* was it a handle to the current thread? */
1445 @END
1446
1447
1448 /* Fetch a selector entry for a thread */
1449 @REQ(get_selector_entry)
1450     obj_handle_t  handle;      /* thread handle */
1451     int           entry;       /* LDT entry */
1452 @REPLY
1453     unsigned int  base;        /* selector base */
1454     unsigned int  limit;       /* selector limit */
1455     unsigned char flags;       /* selector flags */
1456 @END
1457
1458
1459 /* Add an atom */
1460 @REQ(add_atom)
1461     obj_handle_t  table;       /* which table to add atom to */
1462     VARARG(name,unicode_str);  /* atom name */
1463 @REPLY
1464     atom_t        atom;        /* resulting atom */
1465 @END
1466
1467
1468 /* Delete an atom */
1469 @REQ(delete_atom)
1470     obj_handle_t  table;       /* which table to delete atom from */
1471     atom_t        atom;        /* atom handle */
1472 @END
1473
1474
1475 /* Find an atom */
1476 @REQ(find_atom)
1477     obj_handle_t table;        /* which table to find atom from */
1478     VARARG(name,unicode_str);  /* atom name */
1479 @REPLY
1480     atom_t       atom;         /* atom handle */
1481 @END
1482
1483
1484 /* Get information about an atom */
1485 @REQ(get_atom_information)
1486     obj_handle_t table;        /* which table to find atom from */
1487     atom_t       atom;         /* atom handle */
1488 @REPLY
1489     int          count;        /* atom lock count */
1490     int          pinned;       /* whether the atom has been pinned */
1491     size_t       total;        /* actual length of atom name */
1492     VARARG(name,unicode_str);  /* atom name */
1493 @END
1494
1495
1496 /* Set information about an atom */
1497 @REQ(set_atom_information)
1498     obj_handle_t table;        /* which table to find atom from */
1499     atom_t       atom;         /* atom handle */
1500     int          pinned;       /* whether to bump atom information */
1501 @END
1502
1503
1504 /* Empty an atom table */
1505 @REQ(empty_atom_table)
1506     obj_handle_t table;        /* which table to find atom from */
1507     int          if_pinned;    /* whether to delete pinned atoms */
1508 @END
1509
1510
1511 /* Init an atom table */
1512 @REQ(init_atom_table)
1513     int          entries;      /* number of entries (only for local) */
1514 @REPLY
1515     obj_handle_t table;        /* handle to the atom table */
1516 @END
1517
1518
1519 /* Get the message queue of the current thread */
1520 @REQ(get_msg_queue)
1521 @REPLY
1522     obj_handle_t handle;       /* handle to the queue */
1523 @END
1524
1525
1526 /* Set the current message queue wakeup mask */
1527 @REQ(set_queue_mask)
1528     unsigned int wake_mask;    /* wakeup bits mask */
1529     unsigned int changed_mask; /* changed bits mask */
1530     int          skip_wait;    /* will we skip waiting if signaled? */
1531 @REPLY
1532     unsigned int wake_bits;    /* current wake bits */
1533     unsigned int changed_bits; /* current changed bits */
1534 @END
1535
1536
1537 /* Get the current message queue status */
1538 @REQ(get_queue_status)
1539     int          clear;        /* should we clear the change bits? */
1540 @REPLY
1541     unsigned int wake_bits;    /* wake bits */
1542     unsigned int changed_bits; /* changed bits since last time */
1543 @END
1544
1545
1546 /* Wait for a process to start waiting on input */
1547 @REQ(wait_input_idle)
1548     obj_handle_t handle;       /* process handle */
1549     int          timeout;      /* timeout */
1550 @REPLY
1551     obj_handle_t event;        /* handle to idle event */
1552 @END
1553
1554
1555 /* Send a message to a thread queue */
1556 @REQ(send_message)
1557     thread_id_t     id;        /* thread id */
1558     int             type;      /* message type (see below) */
1559     int             flags;     /* message flags (see below) */
1560     user_handle_t   win;       /* window handle */
1561     unsigned int    msg;       /* message code */
1562     unsigned int    wparam;    /* parameters */
1563     unsigned int    lparam;    /* parameters */
1564     int             x;         /* x position */
1565     int             y;         /* y position */
1566     unsigned int    time;      /* message time */
1567     unsigned int    info;      /* extra info */
1568     int             timeout;   /* timeout for reply */
1569     void*           callback;  /* callback address */
1570     VARARG(data,bytes);        /* message data for sent messages */
1571 @END
1572
1573 @REQ(post_quit_message)
1574     int             exit_code; /* exit code to return */
1575 @END
1576
1577 enum message_type
1578 {
1579     MSG_ASCII,          /* Ascii message (from SendMessageA) */
1580     MSG_UNICODE,        /* Unicode message (from SendMessageW) */
1581     MSG_NOTIFY,         /* notify message (from SendNotifyMessageW), always Unicode */
1582     MSG_CALLBACK,       /* callback message (from SendMessageCallbackW), always Unicode */
1583     MSG_CALLBACK_RESULT,/* result of a callback message */
1584     MSG_OTHER_PROCESS,  /* sent from other process, may include vararg data, always Unicode */
1585     MSG_POSTED,         /* posted message (from PostMessageW), always Unicode */
1586     MSG_HARDWARE,       /* hardware message */
1587     MSG_WINEVENT        /* winevent message */
1588 };
1589 #define SEND_MSG_ABORT_IF_HUNG  0x01
1590
1591
1592 /* Get a message from the current queue */
1593 @REQ(get_message)
1594     int             flags;     /* see below */
1595     user_handle_t   get_win;   /* window handle to get */
1596     unsigned int    get_first; /* first message code to get */
1597     unsigned int    get_last;  /* last message code to get */
1598     unsigned int    hw_id;     /* id of the previous hardware message (or 0) */
1599 @REPLY
1600     int             type;      /* message type */
1601     user_handle_t   win;       /* window handle */
1602     unsigned int    msg;       /* message code */
1603     unsigned int    wparam;    /* parameters (callback function for MSG_CALLBACK_RESULT) */
1604     unsigned int    lparam;    /* parameters (result for MSG_CALLBACK_RESULT) */
1605     int             x;         /* x position */
1606     int             y;         /* y position */
1607     user_handle_t   hook;      /* winevent hook handle */
1608     void*           hook_proc; /* winevent hook proc address */
1609     unsigned int    time;      /* message time */
1610     unsigned int    info;      /* extra info (callback argument for MSG_CALLBACK_RESULT) */
1611     unsigned int    hw_id;     /* id if hardware message */
1612     unsigned int    active_hooks; /* active hooks bitmap */
1613     size_t          total;     /* total size of extra data */
1614     VARARG(data,bytes);        /* message data for sent messages */
1615 @END
1616 #define GET_MSG_REMOVE      1  /* remove the message */
1617 #define GET_MSG_SENT_ONLY   2  /* only get sent messages */
1618
1619 /* Reply to a sent message */
1620 @REQ(reply_message)
1621     unsigned int    result;    /* message result */
1622     int             remove;    /* should we remove the message? */
1623     VARARG(data,bytes);        /* message data for sent messages */
1624 @END
1625
1626
1627 /* Accept the current hardware message */
1628 @REQ(accept_hardware_message)
1629     unsigned int    hw_id;     /* id of the hardware message */
1630     int             remove;    /* should we remove the message? */
1631     user_handle_t   new_win;   /* new destination window for current message */
1632 @END
1633
1634
1635 /* Retrieve the reply for the last message sent */
1636 @REQ(get_message_reply)
1637     int             cancel;    /* cancel message if not ready? */
1638 @REPLY
1639     unsigned int    result;    /* message result */
1640     VARARG(data,bytes);        /* message data for sent messages */
1641 @END
1642
1643
1644 /* Set a window timer */
1645 @REQ(set_win_timer)
1646     user_handle_t   win;       /* window handle */
1647     unsigned int    msg;       /* message to post */
1648     unsigned int    id;        /* timer id */
1649     unsigned int    rate;      /* timer rate in ms */
1650     unsigned int    lparam;    /* message lparam (callback proc) */
1651 @REPLY
1652     unsigned int    id;        /* timer id */
1653 @END
1654
1655
1656 /* Kill a window timer */
1657 @REQ(kill_win_timer)
1658     user_handle_t   win;       /* window handle */
1659     unsigned int    msg;       /* message to post */
1660     unsigned int    id;        /* timer id */
1661 @END
1662
1663
1664 /* Retrieve info about a serial port */
1665 @REQ(get_serial_info)
1666     obj_handle_t handle;       /* handle to comm port */
1667 @REPLY
1668     unsigned int readinterval;
1669     unsigned int readconst;
1670     unsigned int readmult;
1671     unsigned int writeconst;
1672     unsigned int writemult;
1673     unsigned int eventmask;
1674 @END
1675
1676
1677 /* Set info about a serial port */
1678 @REQ(set_serial_info)
1679     obj_handle_t handle;       /* handle to comm port */
1680     int          flags;        /* bitmask to set values (see below) */
1681     unsigned int readinterval;
1682     unsigned int readconst;
1683     unsigned int readmult;
1684     unsigned int writeconst;
1685     unsigned int writemult;
1686     unsigned int eventmask;
1687 @END
1688 #define SERIALINFO_SET_TIMEOUTS  0x01
1689 #define SERIALINFO_SET_MASK      0x02
1690
1691
1692 /* Create an async I/O */
1693 @REQ(register_async)
1694     obj_handle_t handle;        /* handle to comm port, socket or file */
1695     int          type;          /* type of queue to look after */
1696     void*        io_apc;        /* APC routine to queue upon end of async */
1697     void*        io_sb;         /* I/O status block (unique across all async on this handle) */
1698     void*        io_user;       /* data to pass back to caller */
1699     int          count;         /* count - usually # of bytes to be read/written */
1700 @END
1701 #define ASYNC_TYPE_READ  0x01
1702 #define ASYNC_TYPE_WRITE 0x02
1703 #define ASYNC_TYPE_WAIT  0x03
1704
1705
1706 /* Cancel all async op on a fd */
1707 @REQ(cancel_async)
1708     obj_handle_t handle;        /* handle to comm port, socket or file */
1709 @END
1710
1711
1712 /* Create a named pipe */
1713 @REQ(create_named_pipe)
1714     unsigned int   access;
1715     unsigned int   attributes;   /* object attributes */
1716     obj_handle_t   rootdir;      /* root directory */
1717     unsigned int   options;
1718     unsigned int   flags;
1719     unsigned int   maxinstances;
1720     unsigned int   outsize;
1721     unsigned int   insize;
1722     unsigned int   timeout;
1723     VARARG(name,unicode_str);    /* pipe name */
1724 @REPLY
1725     obj_handle_t   handle;       /* handle to the pipe */
1726 @END
1727
1728 /* flags in create_named_pipe and get_named_pipe_info */
1729 #define NAMED_PIPE_MESSAGE_STREAM_WRITE 0x0001
1730 #define NAMED_PIPE_MESSAGE_STREAM_READ  0x0002
1731 #define NAMED_PIPE_NONBLOCKING_MODE     0x0004
1732
1733
1734 /* Open an existing named pipe */
1735 @REQ(open_named_pipe)
1736     unsigned int   access;
1737     unsigned int   attributes;   /* object attributes */
1738     obj_handle_t   rootdir;      /* root directory */
1739     unsigned int   flags;        /* file flags */
1740     VARARG(name,unicode_str);    /* pipe name */
1741 @REPLY
1742     obj_handle_t   handle;       /* handle to the pipe */
1743 @END
1744
1745
1746 /* Connect to a named pipe */
1747 @REQ(connect_named_pipe)
1748     obj_handle_t   handle;
1749     obj_handle_t   event;
1750     void*          func;
1751 @END
1752
1753
1754 /* Wait for a named pipe */
1755 @REQ(wait_named_pipe)
1756     obj_handle_t   handle;
1757     unsigned int   timeout;
1758     obj_handle_t   event;
1759     void*          func;
1760     VARARG(name,unicode_str);    /* pipe name */
1761 @END
1762
1763
1764 /* Disconnect a named pipe */
1765 @REQ(disconnect_named_pipe)
1766     obj_handle_t   handle;
1767 @REPLY
1768     int            fd;           /* associated fd to close */
1769 @END
1770
1771
1772 @REQ(get_named_pipe_info)
1773     obj_handle_t   handle;
1774 @REPLY
1775     unsigned int   flags;
1776     unsigned int   maxinstances;
1777     unsigned int   outsize;
1778     unsigned int   insize;
1779 @END
1780
1781
1782 /* Create a window */
1783 @REQ(create_window)
1784     user_handle_t  parent;      /* parent window */
1785     user_handle_t  owner;       /* owner window */
1786     atom_t         atom;        /* class atom */
1787     void*          instance;    /* module instance */
1788 @REPLY
1789     user_handle_t  handle;      /* created window */
1790     user_handle_t  parent;      /* full handle of parent */
1791     user_handle_t  owner;       /* full handle of owner */
1792     int            extra;       /* number of extra bytes */
1793     void*          class_ptr;   /* pointer to class in client address space */
1794 @END
1795
1796
1797 /* Destroy a window */
1798 @REQ(destroy_window)
1799     user_handle_t  handle;      /* handle to the window */
1800 @END
1801
1802
1803 /* Retrieve the desktop window for the current thread */
1804 @REQ(get_desktop_window)
1805     int            force;       /* force creation if it doesn't exist */
1806 @REPLY
1807     user_handle_t  handle;      /* handle to the desktop window */
1808 @END
1809
1810
1811 /* Set a window owner */
1812 @REQ(set_window_owner)
1813     user_handle_t  handle;      /* handle to the window */
1814     user_handle_t  owner;       /* new owner */
1815 @REPLY
1816     user_handle_t  full_owner;  /* full handle of new owner */
1817     user_handle_t  prev_owner;  /* full handle of previous owner */
1818 @END
1819
1820
1821 /* Get information from a window handle */
1822 @REQ(get_window_info)
1823     user_handle_t  handle;      /* handle to the window */
1824 @REPLY
1825     user_handle_t  full_handle; /* full 32-bit handle */
1826     user_handle_t  last_active; /* last active popup */
1827     process_id_t   pid;         /* process owning the window */
1828     thread_id_t    tid;         /* thread owning the window */
1829     atom_t         atom;        /* class atom */
1830     int            is_unicode;  /* ANSI or unicode */
1831 @END
1832
1833
1834 /* Set some information in a window */
1835 @REQ(set_window_info)
1836     user_handle_t  handle;        /* handle to the window */
1837     unsigned int   flags;         /* flags for fields to set (see below) */
1838     unsigned int   style;         /* window style */
1839     unsigned int   ex_style;      /* window extended style */
1840     unsigned int   id;            /* window id */
1841     void*          instance;      /* creator instance */
1842     int            is_unicode;    /* ANSI or unicode */
1843     void*          user_data;     /* user-specific data */
1844     int            extra_offset;  /* offset to set in extra bytes */
1845     size_t         extra_size;    /* size to set in extra bytes */
1846     unsigned int   extra_value;   /* value to set in extra bytes */
1847 @REPLY
1848     unsigned int   old_style;     /* old window style */
1849     unsigned int   old_ex_style;  /* old window extended style */
1850     unsigned int   old_id;        /* old window id */
1851     void*          old_instance;  /* old creator instance */
1852     void*          old_user_data; /* old user-specific data */
1853     unsigned int   old_extra_value; /* old value in extra bytes */
1854 @END
1855 #define SET_WIN_STYLE     0x01
1856 #define SET_WIN_EXSTYLE   0x02
1857 #define SET_WIN_ID        0x04
1858 #define SET_WIN_INSTANCE  0x08
1859 #define SET_WIN_USERDATA  0x10
1860 #define SET_WIN_EXTRA     0x20
1861 #define SET_WIN_UNICODE   0x40
1862
1863
1864 /* Set the parent of a window */
1865 @REQ(set_parent)
1866     user_handle_t  handle;      /* handle to the window */
1867     user_handle_t  parent;      /* handle to the parent */
1868 @REPLY
1869     user_handle_t  old_parent;  /* old parent window */
1870     user_handle_t  full_parent; /* full handle of new parent */
1871 @END
1872
1873
1874 /* Get a list of the window parents, up to the root of the tree */
1875 @REQ(get_window_parents)
1876     user_handle_t  handle;        /* handle to the window */
1877 @REPLY
1878     int            count;         /* total count of parents */
1879     VARARG(parents,user_handles); /* parent handles */
1880 @END
1881
1882
1883 /* Get a list of the window children */
1884 @REQ(get_window_children)
1885     user_handle_t  parent;        /* parent window */
1886     atom_t         atom;          /* class atom for the listed children */
1887     thread_id_t    tid;           /* thread owning the listed children */
1888 @REPLY
1889     int            count;         /* total count of children */
1890     VARARG(children,user_handles); /* children handles */
1891 @END
1892
1893
1894 /* Get a list of the window children that contain a given point */
1895 @REQ(get_window_children_from_point)
1896     user_handle_t  parent;        /* parent window */
1897     int            x;             /* point in parent coordinates */
1898     int            y;
1899 @REPLY
1900     int            count;         /* total count of children */
1901     VARARG(children,user_handles); /* children handles */
1902 @END
1903
1904
1905 /* Get window tree information from a window handle */
1906 @REQ(get_window_tree)
1907     user_handle_t  handle;        /* handle to the window */
1908 @REPLY
1909     user_handle_t  parent;        /* parent window */
1910     user_handle_t  owner;         /* owner window */
1911     user_handle_t  next_sibling;  /* next sibling in Z-order */
1912     user_handle_t  prev_sibling;  /* prev sibling in Z-order */
1913     user_handle_t  first_sibling; /* first sibling in Z-order */
1914     user_handle_t  last_sibling;  /* last sibling in Z-order */
1915     user_handle_t  first_child;   /* first child */
1916     user_handle_t  last_child;    /* last child */
1917 @END
1918
1919 /* Set the position and Z order of a window */
1920 @REQ(set_window_pos)
1921     user_handle_t  handle;        /* handle to the window */
1922     user_handle_t  previous;      /* previous window in Z order */
1923     unsigned int   flags;         /* SWP_* flags */
1924     rectangle_t    window;        /* window rectangle */
1925     rectangle_t    client;        /* client rectangle */
1926     VARARG(valid,rectangles);     /* valid rectangles from WM_NCCALCSIZE */
1927 @REPLY
1928     unsigned int   new_style;     /* new window style */
1929 @END
1930
1931
1932 /* Get the window and client rectangles of a window */
1933 @REQ(get_window_rectangles)
1934     user_handle_t  handle;        /* handle to the window */
1935 @REPLY
1936     rectangle_t    window;        /* window rectangle */
1937     rectangle_t    visible;       /* visible part of the window rectangle */
1938     rectangle_t    client;        /* client rectangle */
1939 @END
1940
1941
1942 /* Get the window text */
1943 @REQ(get_window_text)
1944     user_handle_t  handle;        /* handle to the window */
1945 @REPLY
1946     VARARG(text,unicode_str);     /* window text */
1947 @END
1948
1949
1950 /* Set the window text */
1951 @REQ(set_window_text)
1952     user_handle_t  handle;        /* handle to the window */
1953     VARARG(text,unicode_str);     /* window text */
1954 @END
1955
1956
1957 /* Get the coordinates offset between two windows */
1958 @REQ(get_windows_offset)
1959     user_handle_t  from;          /* handle to the first window */
1960     user_handle_t  to;            /* handle to the second window */
1961 @REPLY
1962     int            x;             /* x coordinate offset */
1963     int            y;             /* y coordinate offset */
1964 @END
1965
1966
1967 /* Get the visible region of a window */
1968 @REQ(get_visible_region)
1969     user_handle_t  window;        /* handle to the window */
1970     unsigned int   flags;         /* DCX flags */
1971 @REPLY
1972     user_handle_t  top_win;       /* top window to clip against */
1973     int            top_org_x;     /* top window visible rect origin in screen coords */
1974     int            top_org_y;
1975     int            win_org_x;     /* window rect origin in screen coords */
1976     int            win_org_y;
1977     size_t         total_size;    /* total size of the resulting region */
1978     VARARG(region,rectangles);    /* list of rectangles for the region (in screen coords) */
1979 @END
1980
1981
1982 /* Get the window region */
1983 @REQ(get_window_region)
1984     user_handle_t  window;        /* handle to the window */
1985 @REPLY
1986     size_t         total_size;    /* total size of the resulting region */
1987     VARARG(region,rectangles);    /* list of rectangles for the region */
1988 @END
1989
1990
1991 /* Set the window region */
1992 @REQ(set_window_region)
1993     user_handle_t  window;        /* handle to the window */
1994     VARARG(region,rectangles);    /* list of rectangles for the region */
1995 @END
1996
1997
1998 /* Get the window update region */
1999 @REQ(get_update_region)
2000     user_handle_t  window;        /* handle to the window */
2001     user_handle_t  from_child;    /* child to start searching from */
2002     unsigned int   flags;         /* update flags (see below) */
2003 @REPLY
2004     user_handle_t  child;         /* child to repaint (or window itself) */
2005     unsigned int   flags;         /* resulting update flags (see below) */
2006     size_t         total_size;    /* total size of the resulting region */
2007     VARARG(region,rectangles);    /* list of rectangles for the region */
2008 @END
2009 #define UPDATE_NONCLIENT       0x01  /* get region for repainting non-client area */
2010 #define UPDATE_ERASE           0x02  /* get region for erasing client area */
2011 #define UPDATE_PAINT           0x04  /* get region for painting client area */
2012 #define UPDATE_INTERNALPAINT   0x08  /* get region if internal paint is pending */
2013 #define UPDATE_ALLCHILDREN     0x10  /* force repaint of all children */
2014 #define UPDATE_NOCHILDREN      0x20  /* don't try to repaint any children */
2015 #define UPDATE_NOREGION        0x40  /* don't return a region, only the flags */
2016
2017
2018 /* Update the z order of a window so that a given rectangle is fully visible */
2019 @REQ(update_window_zorder)
2020     user_handle_t  window;        /* handle to the window */
2021     rectangle_t    rect;          /* rectangle that must be visible */
2022 @END
2023
2024
2025 /* Mark parts of a window as needing a redraw */
2026 @REQ(redraw_window)
2027     user_handle_t  window;        /* handle to the window */
2028     unsigned int   flags;         /* RDW_* flags */
2029     VARARG(region,rectangles);    /* list of rectangles for the region */
2030 @END
2031
2032
2033 /* Set a window property */
2034 @REQ(set_window_property)
2035     user_handle_t  window;        /* handle to the window */
2036     atom_t         atom;          /* property atom (if no name specified) */
2037     obj_handle_t   handle;        /* handle to store */
2038     VARARG(name,unicode_str);     /* property name */
2039 @END
2040
2041
2042 /* Remove a window property */
2043 @REQ(remove_window_property)
2044     user_handle_t  window;        /* handle to the window */
2045     atom_t         atom;          /* property atom (if no name specified) */
2046     VARARG(name,unicode_str);     /* property name */
2047 @REPLY
2048     obj_handle_t   handle;        /* handle stored in property */
2049 @END
2050
2051
2052 /* Get a window property */
2053 @REQ(get_window_property)
2054     user_handle_t  window;        /* handle to the window */
2055     atom_t         atom;          /* property atom (if no name specified) */
2056     VARARG(name,unicode_str);     /* property name */
2057 @REPLY
2058     obj_handle_t   handle;        /* handle stored in property */
2059 @END
2060
2061
2062 /* Get the list of properties of a window */
2063 @REQ(get_window_properties)
2064     user_handle_t  window;        /* handle to the window */
2065 @REPLY
2066     int            total;         /* total number of properties */
2067     VARARG(props,properties);     /* list of properties */
2068 @END
2069
2070
2071 /* Create a window station */
2072 @REQ(create_winstation)
2073     unsigned int flags;           /* window station flags */
2074     unsigned int access;          /* wanted access rights */
2075     unsigned int attributes;      /* object attributes */
2076     VARARG(name,unicode_str);     /* object name */
2077 @REPLY
2078     obj_handle_t handle;          /* handle to the window station */
2079 @END
2080
2081
2082 /* Open a handle to a window station */
2083 @REQ(open_winstation)
2084     unsigned int access;          /* wanted access rights */
2085     unsigned int attributes;      /* object attributes */
2086     VARARG(name,unicode_str);     /* object name */
2087 @REPLY
2088     obj_handle_t handle;          /* handle to the window station */
2089 @END
2090
2091
2092 /* Close a window station */
2093 @REQ(close_winstation)
2094     obj_handle_t handle;          /* handle to the window station */
2095 @END
2096
2097
2098 /* Get the process current window station */
2099 @REQ(get_process_winstation)
2100 @REPLY
2101     obj_handle_t handle;          /* handle to the window station */
2102 @END
2103
2104
2105 /* Set the process current window station */
2106 @REQ(set_process_winstation)
2107     obj_handle_t handle;          /* handle to the window station */
2108 @END
2109
2110
2111 /* Create a desktop */
2112 @REQ(create_desktop)
2113     unsigned int flags;           /* desktop flags */
2114     unsigned int access;          /* wanted access rights */
2115     unsigned int attributes;      /* object attributes */
2116     VARARG(name,unicode_str);     /* object name */
2117 @REPLY
2118     obj_handle_t handle;          /* handle to the desktop */
2119 @END
2120
2121
2122 /* Open a handle to a desktop */
2123 @REQ(open_desktop)
2124     unsigned int flags;           /* desktop flags */
2125     unsigned int access;          /* wanted access rights */
2126     unsigned int attributes;      /* object attributes */
2127     VARARG(name,unicode_str);     /* object name */
2128 @REPLY
2129     obj_handle_t handle;          /* handle to the desktop */
2130 @END
2131
2132
2133 /* Close a desktop */
2134 @REQ(close_desktop)
2135     obj_handle_t handle;          /* handle to the desktop */
2136 @END
2137
2138
2139 /* Get the thread current desktop */
2140 @REQ(get_thread_desktop)
2141     thread_id_t  tid;             /* thread id */
2142 @REPLY
2143     obj_handle_t handle;          /* handle to the desktop */
2144 @END
2145
2146
2147 /* Set the thread current desktop */
2148 @REQ(set_thread_desktop)
2149     obj_handle_t handle;          /* handle to the desktop */
2150 @END
2151
2152
2153 /* Get/set information about a user object (window station or desktop) */
2154 @REQ(set_user_object_info)
2155     obj_handle_t handle;          /* handle to the object */
2156     unsigned int flags;           /* information to set */
2157     unsigned int obj_flags;       /* new object flags */
2158 @REPLY
2159     int          is_desktop;      /* is object a desktop? */
2160     unsigned int old_obj_flags;   /* old object flags */
2161     VARARG(name,unicode_str);     /* object name */
2162 @END
2163 #define SET_USER_OBJECT_FLAGS 1
2164
2165
2166 /* Attach (or detach) thread inputs */
2167 @REQ(attach_thread_input)
2168     thread_id_t    tid_from;       /* thread to be attached */
2169     thread_id_t    tid_to;         /* thread to which tid_from should be attached */
2170     int            attach;         /* is it an attach? */
2171 @END
2172
2173
2174 /* Get input data for a given thread */
2175 @REQ(get_thread_input)
2176     thread_id_t    tid;           /* id of thread */
2177 @REPLY
2178     user_handle_t  focus;         /* handle to the focus window */
2179     user_handle_t  capture;       /* handle to the capture window */
2180     user_handle_t  active;        /* handle to the active window */
2181     user_handle_t  foreground;    /* handle to the global foreground window */
2182     user_handle_t  menu_owner;    /* handle to the menu owner */
2183     user_handle_t  move_size;     /* handle to the moving/resizing window */
2184     user_handle_t  caret;         /* handle to the caret window */
2185     rectangle_t    rect;          /* caret rectangle */
2186 @END
2187
2188
2189 /* Get the time of the last input event */
2190 @REQ(get_last_input_time)
2191 @REPLY
2192     unsigned int time;
2193 @END
2194
2195
2196 /* Retrieve queue keyboard state for a given thread */
2197 @REQ(get_key_state)
2198     thread_id_t    tid;           /* id of thread */
2199     int            key;           /* optional key code or -1 */
2200 @REPLY
2201     unsigned char  state;         /* state of specified key */
2202     VARARG(keystate,bytes);       /* state array for all the keys */
2203 @END
2204
2205 /* Set queue keyboard state for a given thread */
2206 @REQ(set_key_state)
2207     thread_id_t    tid;           /* id of thread */
2208     VARARG(keystate,bytes);       /* state array for all the keys */
2209 @END
2210
2211 /* Set the system foreground window */
2212 @REQ(set_foreground_window)
2213     user_handle_t  handle;        /* handle to the foreground window */
2214 @REPLY
2215     user_handle_t  previous;      /* handle to the previous foreground window */
2216     int            send_msg_old;  /* whether we have to send a msg to the old window */
2217     int            send_msg_new;  /* whether we have to send a msg to the new window */
2218 @END
2219
2220 /* Set the current thread focus window */
2221 @REQ(set_focus_window)
2222     user_handle_t  handle;        /* handle to the focus window */
2223 @REPLY
2224     user_handle_t  previous;      /* handle to the previous focus window */
2225 @END
2226
2227 /* Set the current thread active window */
2228 @REQ(set_active_window)
2229     user_handle_t  handle;        /* handle to the active window */
2230 @REPLY
2231     user_handle_t  previous;      /* handle to the previous active window */
2232 @END
2233
2234 /* Set the current thread capture window */
2235 @REQ(set_capture_window)
2236     user_handle_t  handle;        /* handle to the capture window */
2237     unsigned int   flags;         /* capture flags (see below) */
2238 @REPLY
2239     user_handle_t  previous;      /* handle to the previous capture window */
2240     user_handle_t  full_handle;   /* full 32-bit handle of new capture window */
2241 @END
2242 #define CAPTURE_MENU     0x01  /* capture is for a menu */
2243 #define CAPTURE_MOVESIZE 0x02  /* capture is for moving/resizing */
2244
2245
2246 /* Set the current thread caret window */
2247 @REQ(set_caret_window)
2248     user_handle_t  handle;        /* handle to the caret window */
2249     int            width;         /* caret width */
2250     int            height;        /* caret height */
2251 @REPLY
2252     user_handle_t  previous;      /* handle to the previous caret window */
2253     rectangle_t    old_rect;      /* previous caret rectangle */
2254     int            old_hide;      /* previous hide count */
2255     int            old_state;     /* previous caret state (1=on, 0=off) */
2256 @END
2257
2258
2259 /* Set the current thread caret information */
2260 @REQ(set_caret_info)
2261     unsigned int   flags;         /* caret flags (see below) */
2262     user_handle_t  handle;        /* handle to the caret window */
2263     int            x;             /* caret x position */
2264     int            y;             /* caret y position */
2265     int            hide;          /* increment for hide count (can be negative to show it) */
2266     int            state;         /* caret state (1=on, 0=off, -1=toggle current state) */
2267 @REPLY
2268     user_handle_t  full_handle;   /* handle to the current caret window */
2269     rectangle_t    old_rect;      /* previous caret rectangle */
2270     int            old_hide;      /* previous hide count */
2271     int            old_state;     /* previous caret state (1=on, 0=off) */
2272 @END
2273 #define SET_CARET_POS        0x01  /* set the caret position from x,y */
2274 #define SET_CARET_HIDE       0x02  /* increment the caret hide count */
2275 #define SET_CARET_STATE      0x04  /* set the caret on/off state */
2276
2277
2278 /* Set a window hook */
2279 @REQ(set_hook)
2280     int            id;             /* id of the hook */
2281     process_id_t   pid;            /* id of process to set the hook into */
2282     thread_id_t    tid;            /* id of thread to set the hook into */
2283     int            event_min;
2284     int            event_max;
2285     int            flags;
2286     void*          proc;           /* hook procedure */
2287     int            unicode;        /* is it a unicode hook? */
2288     VARARG(module,unicode_str);    /* module name */
2289 @REPLY
2290     user_handle_t  handle;         /* handle to the hook */
2291     unsigned int   active_hooks;   /* active hooks bitmap */
2292 @END
2293
2294
2295 /* Remove a window hook */
2296 @REQ(remove_hook)
2297     user_handle_t  handle;         /* handle to the hook */
2298     int            id;             /* id of the hook if handle is 0 */
2299     void*          proc;           /* hook procedure if handle is 0 */
2300 @REPLY
2301     unsigned int   active_hooks;   /* active hooks bitmap */
2302 @END
2303
2304
2305 /* Start calling a hook chain */
2306 @REQ(start_hook_chain)
2307     int            id;             /* id of the hook */
2308     int            event;          /* signalled event */
2309     user_handle_t  window;         /* handle to the event window */
2310     int            object_id;      /* object id for out of context winevent */
2311     int            child_id;       /* child id for out of context winevent */
2312 @REPLY
2313     user_handle_t  handle;         /* handle to the next hook */
2314     process_id_t   pid;            /* process id for low-level keyboard/mouse hooks */
2315     thread_id_t    tid;            /* thread id for low-level keyboard/mouse hooks */
2316     void*          proc;           /* hook procedure */
2317     int            unicode;        /* is it a unicode hook? */
2318     unsigned int   active_hooks;   /* active hooks bitmap */
2319     VARARG(module,unicode_str);    /* module name */
2320 @END
2321
2322
2323 /* Finished calling a hook chain */
2324 @REQ(finish_hook_chain)
2325     int            id;             /* id of the hook */
2326 @END
2327
2328
2329 /* Get the next hook to call */
2330 @REQ(get_next_hook)
2331     user_handle_t  handle;         /* handle to the current hook */
2332     int            event;          /* signalled event */
2333     user_handle_t  window;         /* handle to the event window */
2334     int            object_id;      /* object id for out of context winevent */
2335     int            child_id;       /* child id for out of context winevent */
2336 @REPLY
2337     user_handle_t  next;           /* handle to the next hook */
2338     int            id;             /* id of the next hook */
2339     process_id_t   pid;            /* process id for low-level keyboard/mouse hooks */
2340     thread_id_t    tid;            /* thread id for low-level keyboard/mouse hooks */
2341     void*          proc;           /* next hook procedure */
2342     int            prev_unicode;   /* was the previous a unicode hook? */
2343     int            next_unicode;   /* is the next a unicode hook? */
2344     VARARG(module,unicode_str);    /* module name */
2345 @END
2346
2347
2348 /* Create a window class */
2349 @REQ(create_class)
2350     int            local;          /* is it a local class? */
2351     atom_t         atom;           /* class atom */
2352     unsigned int   style;          /* class style */
2353     void*          instance;       /* module instance */
2354     int            extra;          /* number of extra class bytes */
2355     int            win_extra;      /* number of window extra bytes */
2356     void*          client_ptr;     /* pointer to class in client address space */
2357 @END
2358
2359
2360 /* Destroy a window class */
2361 @REQ(destroy_class)
2362     atom_t         atom;           /* class atom */
2363     void*          instance;       /* module instance */
2364 @REPLY
2365     void*          client_ptr;     /* pointer to class in client address space */
2366 @END
2367
2368
2369 /* Set some information in a class */
2370 @REQ(set_class_info)
2371     user_handle_t  window;         /* handle to the window */
2372     unsigned int   flags;          /* flags for info to set (see below) */
2373     atom_t         atom;           /* class atom */
2374     unsigned int   style;          /* class style */
2375     int            win_extra;      /* number of window extra bytes */
2376     void*          instance;       /* module instance */
2377     int            extra_offset;   /* offset to set in extra bytes */
2378     size_t         extra_size;     /* size to set in extra bytes */
2379     unsigned int   extra_value;    /* value to set in extra bytes */
2380 @REPLY
2381     atom_t         old_atom;       /* previous class atom */
2382     unsigned int   old_style;      /* previous class style */
2383     int            old_extra;      /* previous number of class extra bytes */
2384     int            old_win_extra;  /* previous number of window extra bytes */
2385     void*          old_instance;   /* previous module instance */
2386     unsigned int   old_extra_value; /* old value in extra bytes */
2387 @END
2388 #define SET_CLASS_ATOM      0x0001
2389 #define SET_CLASS_STYLE     0x0002
2390 #define SET_CLASS_WINEXTRA  0x0004
2391 #define SET_CLASS_INSTANCE  0x0008
2392 #define SET_CLASS_EXTRA     0x0010
2393
2394
2395 /* Set/get clipboard information */
2396 @REQ(set_clipboard_info)
2397     unsigned int   flags;       /* flags for fields to set (see below) */
2398     user_handle_t  clipboard;   /* clipboard window */
2399     user_handle_t  owner;       /* clipboard owner */
2400     user_handle_t  viewer;      /* first clipboard viewer */
2401     unsigned int   seqno;       /* change sequence number */
2402 @REPLY
2403     unsigned int   flags;           /* status flags (see below) */
2404     user_handle_t  old_clipboard;   /* old clipboard window */
2405     user_handle_t  old_owner;       /* old clipboard owner */
2406     user_handle_t  old_viewer;      /* old clipboard viewer */
2407     unsigned int   seqno;           /* current sequence number */
2408 @END
2409
2410 #define SET_CB_OPEN      0x001
2411 #define SET_CB_OWNER     0x002
2412 #define SET_CB_VIEWER    0x004
2413 #define SET_CB_SEQNO     0x008
2414 #define SET_CB_RELOWNER  0x010
2415 #define SET_CB_CLOSE     0x020
2416 #define CB_OPEN          0x040
2417 #define CB_OWNER         0x080
2418 #define CB_PROCESS       0x100
2419
2420
2421 /* Open a security token */
2422 @REQ(open_token)
2423     obj_handle_t   handle;    /* handle to the thread or process */
2424     unsigned int   access;    /* access rights to the new token */
2425     unsigned int   attributes;/* object attributes */
2426     unsigned int   flags;     /* flags (see below) */
2427 @REPLY
2428     obj_handle_t   token;    /* handle to the token */
2429 @END
2430 #define OPEN_TOKEN_THREAD   1
2431 #define OPEN_TOKEN_AS_SELF  2
2432
2433
2434 /* Set/get the global windows */
2435 @REQ(set_global_windows)
2436     unsigned int   flags;               /* flags for fields to set (see below) */
2437     user_handle_t  shell_window;        /* handle to the new shell window */
2438     user_handle_t  shell_listview;      /* handle to the new shell listview window */
2439     user_handle_t  progman_window;      /* handle to the new program manager window */
2440     user_handle_t  taskman_window;      /* handle to the new task manager window */
2441 @REPLY
2442     user_handle_t  old_shell_window;    /* handle to the shell window */
2443     user_handle_t  old_shell_listview;  /* handle to the shell listview window */
2444     user_handle_t  old_progman_window;  /* handle to the new program manager window */
2445     user_handle_t  old_taskman_window;  /* handle to the new task manager window */
2446 @END
2447 #define SET_GLOBAL_SHELL_WINDOWS   0x01  /* set both main shell and listview windows */
2448 #define SET_GLOBAL_PROGMAN_WINDOW  0x02
2449 #define SET_GLOBAL_TASKMAN_WINDOW  0x04
2450
2451 /* Adjust the privileges held by a token */
2452 @REQ(adjust_token_privileges)
2453     obj_handle_t  handle; /* handle to the token */
2454     int           disable_all; /* disable all privileges? */
2455     int           get_modified_state; /* get modified privileges? */
2456     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to enable/disable/remove */
2457 @REPLY
2458     unsigned int  len; /* total length in bytes required to store token privileges */
2459     VARARG(privileges,LUID_AND_ATTRIBUTES); /* modified privileges */
2460 @END
2461
2462 /* Retrieves the set of privileges held by or available to a token */
2463 @REQ(get_token_privileges)
2464     obj_handle_t  handle; /* handle to the token */
2465 @REPLY
2466     unsigned int  len; /* total length in bytes required to store token privileges */
2467     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
2468 @END
2469
2470 /* Check the token has the required privileges */
2471 @REQ(check_token_privileges)
2472     obj_handle_t  handle; /* handle to the token */
2473     int           all_required; /* are all the privileges required for the check to succeed? */
2474     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to check */
2475 @REPLY
2476     int           has_privileges; /* does the token have the required privileges? */
2477     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
2478 @END
2479
2480 @REQ(duplicate_token)
2481     obj_handle_t  handle;        /* handle to the token to duplicate */
2482     unsigned int  access;        /* access rights to the new token */
2483     unsigned int  attributes;    /* object attributes */
2484     int           primary;       /* is the new token to be a primary one? */
2485     int           impersonation_level; /* impersonation level of the new token */
2486 @REPLY
2487     obj_handle_t  new_handle; /* duplicated handle */
2488 @END
2489
2490 @REQ(access_check)
2491     obj_handle_t    handle; /* handle to the token */
2492     unsigned int    desired_access; /* desired access to the object */
2493     unsigned int    mapping_read; /* mapping from generic read to specific rights */
2494     unsigned int    mapping_write; /* mapping from generic write to specific rights */
2495     unsigned int    mapping_execute; /* mapping from generic execute to specific rights */
2496     unsigned int    mapping_all; /* mapping from generic all to specific rights */
2497     VARARG(sd,security_descriptor); /* security descriptor to check */
2498 @REPLY
2499     unsigned int    access_granted; /* access rights actually granted */
2500     unsigned int    access_status; /* was access granted? */
2501     unsigned int    privileges_len; /* length needed to store privileges */
2502     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges used during access check */
2503 @END
2504
2505 @REQ(get_token_user)
2506     obj_handle_t    handle;       /* handle to the token */
2507 @REPLY
2508     size_t          user_len;     /* length needed to store user */
2509     VARARG(user,SID);             /* sid of the user the token represents */
2510 @END
2511
2512 /* Create a mailslot */
2513 @REQ(create_mailslot)
2514     unsigned int   access;        /* wanted access rights */
2515     unsigned int   attributes;    /* object attributes */
2516     obj_handle_t   rootdir;       /* root directory */
2517     unsigned int   max_msgsize;
2518     int            read_timeout;
2519     VARARG(name,unicode_str);     /* mailslot name */
2520 @REPLY
2521     obj_handle_t   handle;        /* handle to the mailslot */
2522 @END
2523
2524
2525 /* Open an existing mailslot */
2526 @REQ(open_mailslot)
2527     unsigned int   access;
2528     unsigned int   attributes;    /* object attributes */
2529     obj_handle_t   rootdir;       /* root directory */
2530     unsigned int   sharing;       /* sharing mode */
2531     VARARG(name,unicode_str);     /* mailslot name */
2532 @REPLY
2533     obj_handle_t   handle;        /* handle to the mailslot */
2534 @END
2535
2536
2537 /* Set mailslot information */
2538 @REQ(set_mailslot_info)
2539     obj_handle_t   handle;        /* handle to the mailslot */
2540     unsigned int   flags;
2541     int            read_timeout;
2542 @REPLY
2543     unsigned int   max_msgsize;
2544     int            read_timeout;
2545     unsigned int   msg_count;
2546     unsigned int   next_msgsize;
2547 @END
2548 #define MAILSLOT_SET_READ_TIMEOUT  1
2549
2550
2551 /* Create a directory object */
2552 @REQ(create_directory)
2553     unsigned int   access;        /* access flags */
2554     unsigned int   attributes;    /* object attributes */
2555     obj_handle_t   rootdir;       /* root directory */
2556     VARARG(directory_name,unicode_str); /* Directory name */
2557 @REPLY
2558     obj_handle_t   handle;        /* handle to the directory */
2559 @END
2560
2561
2562 /* Open a directory object */
2563 @REQ(open_directory)
2564     unsigned int   access;        /* access flags */
2565     unsigned int   attributes;    /* object attributes */
2566     obj_handle_t   rootdir;       /* root directory */
2567     VARARG(directory_name,unicode_str); /* Directory name */
2568 @REPLY
2569     obj_handle_t   handle;        /* handle to the directory */
2570 @END
2571
2572
2573 /* Create a symbolic link object */
2574 @REQ(create_symlink)
2575     unsigned int   access;        /* access flags */
2576     unsigned int   attributes;    /* object attributes */
2577     obj_handle_t   rootdir;       /* root directory */
2578     size_t         name_len;      /* length of the symlink name in bytes */
2579     VARARG(name,unicode_str,name_len); /* symlink name */
2580     VARARG(target_name,unicode_str);   /* target name */
2581 @REPLY
2582     obj_handle_t   handle;        /* handle to the symlink */
2583 @END
2584
2585
2586 /* Open a symbolic link object */
2587 @REQ(open_symlink)
2588     unsigned int   access;        /* access flags */
2589     unsigned int   attributes;    /* object attributes */
2590     obj_handle_t   rootdir;       /* root directory */
2591     VARARG(name,unicode_str);     /* symlink name */
2592 @REPLY
2593     obj_handle_t   handle;        /* handle to the symlink */
2594 @END
2595
2596
2597 /* Query a symbolic link object */
2598 @REQ(query_symlink)
2599     obj_handle_t   handle;        /* handle to the symlink */
2600 @REPLY
2601     VARARG(target_name,unicode_str); /* target name */
2602 @END