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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, 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 typedef unsigned int obj_handle_t;
  35 typedef unsigned int user_handle_t;
  36 typedef unsigned int atom_t;
  37 typedef unsigned int process_id_t;
  38 typedef unsigned int thread_id_t;
  39 typedef unsigned int data_size_t;
  40 typedef unsigned int ioctl_code_t;
  41 typedef unsigned __int64 lparam_t;
  42 typedef unsigned __int64 apc_param_t;
  43 typedef unsigned __int64 mem_size_t;
  44 typedef unsigned __int64 file_pos_t;
  45 typedef unsigned __int64 client_ptr_t;
  46 typedef unsigned __int64 affinity_t;
  47 typedef client_ptr_t mod_handle_t;
  48
  49 struct request_header
  50 {
  51     int          req;          /* request code */
  52     data_size_t  request_size; /* request variable part size */
  53     data_size_t  reply_size;   /* reply variable part maximum size */
  54 };
  55
  56 struct reply_header
  57 {
  58     unsigned int error;        /* error result */
  59     data_size_t  reply_size;   /* reply variable part size */
  60 };
  61
  62 /* placeholder structure for the maximum allowed request size */
  63 /* this is used to construct the generic_request union */
  64 struct request_max_size
  65 {
  66     int pad[16]; /* the max request size is 16 ints */
  67 };
  68
  69 #define FIRST_USER_HANDLE 0x0020  /* first possible value for low word of user handle */
  70 #define LAST_USER_HANDLE  0xffef  /* last possible value for low word of user handle */
  71
  72
  73 /* debug event data */
  74 typedef union
  75 {
  76     int code;   /* event code */
  77     struct
  78     {
  79         int              code;       /* EXCEPTION_DEBUG_EVENT */
  80         int              first;      /* first chance exception? */
  81         unsigned int     exc_code;   /* exception code */
  82         unsigned int     flags;      /* exception flags */
  83         client_ptr_t     record;     /* exception record */
  84         client_ptr_t     address;    /* exception address */
  85         int              nb_params;  /* number of parameters */
  86         int              __pad;
  87         client_ptr_t     params[15]; /* parameters */
  88     } exception;
  89     struct
  90     {
  91         int          code;       /* CREATE_THREAD_DEBUG_EVENT */
  92         obj_handle_t handle;     /* handle to the new thread */
  93         client_ptr_t teb;        /* thread teb (in debugged process address space) */
  94         client_ptr_t start;      /* thread startup routine */
  95     } create_thread;
  96     struct
  97     {
  98         int          code;       /* CREATE_PROCESS_DEBUG_EVENT */
  99         obj_handle_t file;       /* handle to the process exe file */
 100         obj_handle_t process;    /* handle to the new process */
 101         obj_handle_t thread;     /* handle to the new thread */
 102         mod_handle_t base;       /* base of executable image */
 103         int          dbg_offset; /* offset of debug info in file */
 104         int          dbg_size;   /* size of debug info */
 105         client_ptr_t teb;        /* thread teb (in debugged process address space) */
 106         client_ptr_t start;      /* thread startup routine */
 107         client_ptr_t name;       /* image name (optional) */
 108         int          unicode;    /* is it Unicode? */
 109     } create_process;
 110     struct
 111     {
 112         int          code;       /* EXIT_THREAD_DEBUG_EVENT/EXIT_PROCESS_DEBUG_EVENT */
 113         int          exit_code;  /* thread or process exit code */
 114     } exit;
 115     struct
 116     {
 117         int          code;       /* LOAD_DLL_DEBUG_EVENT */
 118         obj_handle_t handle;     /* file handle for the dll */
 119         mod_handle_t base;       /* base address of the dll */
 120         int          dbg_offset; /* offset of debug info in file */
 121         int          dbg_size;   /* size of debug info */
 122         client_ptr_t name;       /* image name (optional) */
 123         int          unicode;    /* is it Unicode? */
 124     } load_dll;
 125     struct
 126     {
 127         int          code;       /* UNLOAD_DLL_DEBUG_EVENT */
 128         int          __pad;
 129         mod_handle_t base;       /* base address of the dll */
 130     } unload_dll;
 131 } debug_event_t;
 132
 133 /* supported CPU types */
 134 enum cpu_type
 135 {
 136     CPU_x86, CPU_x86_64, CPU_POWERPC, CPU_ARM, CPU_ARM64
 137 };
 138 typedef int cpu_type_t;
 139
 140 /* context data */
 141 typedef struct
 142 {
 143     cpu_type_t       cpu;        /* cpu type */
 144     unsigned int     flags;      /* SERVER_CTX_* flags */
 145     union
 146     {
 147         struct { unsigned int eip, ebp, esp, eflags, cs, ss; } i386_regs;
 148         struct { unsigned __int64 rip, rbp, rsp;
 149                  unsigned int cs, ss, flags, __pad; } x86_64_regs;
 150         struct { unsigned int iar, msr, ctr, lr, dar, dsisr, trap, __pad; } powerpc_regs;
 151         struct { unsigned int sp, lr, pc, cpsr; } arm_regs;
 152         struct { unsigned __int64 sp, pc, pstate; } arm64_regs;
 153     } ctl;  /* selected by SERVER_CTX_CONTROL */
 154     union
 155     {
 156         struct { unsigned int eax, ebx, ecx, edx, esi, edi; } i386_regs;
 157         struct { unsigned __int64 rax,rbx, rcx, rdx, rsi, rdi,
 158                                   r8, r9, r10, r11, r12, r13, r14, r15; } x86_64_regs;
 159         struct { unsigned int gpr[32], cr, xer; } powerpc_regs;
 160         struct { unsigned int r[13]; } arm_regs;
 161         struct { unsigned __int64 x[31]; } arm64_regs;
 162     } integer;  /* selected by SERVER_CTX_INTEGER */
 163     union
 164     {
 165         struct { unsigned int ds, es, fs, gs; } i386_regs;
 166         struct { unsigned int ds, es, fs, gs; } x86_64_regs;
 167     } seg;  /* selected by SERVER_CTX_SEGMENTS */
 168     union
 169     {
 170         struct { unsigned int ctrl, status, tag, err_off, err_sel, data_off, data_sel, cr0npx;
 171                  unsigned char regs[80]; } i386_regs;
 172         struct { struct { unsigned __int64 low, high; } fpregs[32]; } x86_64_regs;
 173         struct { double fpr[32], fpscr; } powerpc_regs;
 174         struct { unsigned __int64 d[32]; unsigned int fpscr; } arm_regs;
 175         struct { unsigned __int64 d[64]; unsigned int fpcr, fpsr; } arm64_regs;
 176     } fp;  /* selected by SERVER_CTX_FLOATING_POINT */
 177     union
 178     {
 179         struct { unsigned int dr0, dr1, dr2, dr3, dr6, dr7; } i386_regs;
 180         struct { unsigned __int64 dr0, dr1, dr2, dr3, dr6, dr7; } x86_64_regs;
 181         struct { unsigned int dr[8]; } powerpc_regs;
 182         struct { unsigned int bvr[8], bcr[8], wvr[1], wcr[1]; } arm_regs;
 183         struct { unsigned __int64 bvr[8], wvr[2]; unsigned int bcr[8], wcr[2]; } arm64_regs;
 184     } debug;  /* selected by SERVER_CTX_DEBUG_REGISTERS */
 185     union
 186     {
 187         unsigned char i386_regs[512];
 188     } ext;                       /* selected by SERVER_CTX_EXTENDED_REGISTERS */
 189 } context_t;
 190
 191 #define SERVER_CTX_CONTROL            0x01
 192 #define SERVER_CTX_INTEGER            0x02
 193 #define SERVER_CTX_SEGMENTS           0x04
 194 #define SERVER_CTX_FLOATING_POINT     0x08
 195 #define SERVER_CTX_DEBUG_REGISTERS    0x10
 196 #define SERVER_CTX_EXTENDED_REGISTERS 0x20
 197
 198 /* structure used in sending an fd from client to server */
 199 struct send_fd
 200 {
 201     thread_id_t tid;  /* thread id */
 202     int         fd;   /* file descriptor on client-side */
 203 };
 204
 205 /* structure sent by the server on the wait fifo */
 206 struct wake_up_reply
 207 {
 208     client_ptr_t cookie;    /* magic cookie that was passed in select_request */
 209     int          signaled;  /* wait result */
 210     int          __pad;
 211 };
 212
 213 /* NT-style timeout, in 100ns units, negative means relative timeout */
 214 typedef __int64 timeout_t;
 215 #define TIMEOUT_INFINITE (((timeout_t)0x7fffffff) << 32 | 0xffffffff)
 216
 217 /* structure for process startup info */
 218 typedef struct
 219 {
 220     unsigned int debug_flags;
 221     unsigned int console_flags;
 222     obj_handle_t console;
 223     obj_handle_t hstdin;
 224     obj_handle_t hstdout;
 225     obj_handle_t hstderr;
 226     unsigned int x;
 227     unsigned int y;
 228     unsigned int xsize;
 229     unsigned int ysize;
 230     unsigned int xchars;
 231     unsigned int ychars;
 232     unsigned int attribute;
 233     unsigned int flags;
 234     unsigned int show;
 235     data_size_t  curdir_len;
 236     data_size_t  dllpath_len;
 237     data_size_t  imagepath_len;
 238     data_size_t  cmdline_len;
 239     data_size_t  title_len;
 240     data_size_t  desktop_len;
 241     data_size_t  shellinfo_len;
 242     data_size_t  runtime_len;
 243     /* VARARG(curdir,unicode_str,curdir_len); */
 244     /* VARARG(dllpath,unicode_str,dllpath_len); */
 245     /* VARARG(imagepath,unicode_str,imagepath_len); */
 246     /* VARARG(cmdline,unicode_str,cmdline_len); */
 247     /* VARARG(title,unicode_str,title_len); */
 248     /* VARARG(desktop,unicode_str,desktop_len); */
 249     /* VARARG(shellinfo,unicode_str,shellinfo_len); */
 250     /* VARARG(runtime,unicode_str,runtime_len); */
 251 } startup_info_t;
 252
 253 /* structure returned in the list of window properties */
 254 typedef struct
 255 {
 256     atom_t         atom;     /* property atom */
 257     int            string;   /* was atom a string originally? */
 258     lparam_t       data;     /* data stored in property */
 259 } property_data_t;
 260
 261 /* structure to specify window rectangles */
 262 typedef struct
 263 {
 264     int  left;
 265     int  top;
 266     int  right;
 267     int  bottom;
 268 } rectangle_t;
 269
 270 /* structure for parameters of async I/O calls */
 271 typedef struct
 272 {
 273     obj_handle_t    handle;        /* object to perform I/O on */
 274     obj_handle_t    event;         /* event to signal when done */
 275     client_ptr_t    iosb;          /* I/O status block in client addr space */
 276     client_ptr_t    user;          /* opaque user data containing callback pointer and async-specific data */
 277     client_ptr_t    apc;           /* user APC to call */
 278     apc_param_t     apc_context;   /* user APC context or completion value */
 279 } async_data_t;
 280
 281 /* structures for extra message data */
 282
 283 struct hw_msg_source
 284 {
 285     unsigned int    device;        /* source device (IMDT_* values) */
 286     unsigned int    origin;        /* source origin (IMO_* values) */
 287 };
 288
 289 struct hardware_msg_data
 290 {
 291     lparam_t             info;      /* extra info */
 292     unsigned int         hw_id;     /* unique id */
 293     unsigned int         flags;     /* hook flags */
 294     struct hw_msg_source source;    /* message source */
 295     union
 296     {
 297         int type;
 298         struct
 299         {
 300             int            type;    /* RIM_TYPEKEYBOARD */
 301             unsigned int   message; /* message generated by this rawinput event */
 302             unsigned short vkey;    /* virtual key code */
 303             unsigned short scan;    /* scan code */
 304         } kbd;
 305         struct
 306         {
 307             int            type;    /* RIM_TYPEMOUSE */
 308             int            x;       /* x coordinate */
 309             int            y;       /* y coordinate */
 310             unsigned int   data;    /* mouse data */
 311         } mouse;
 312     } rawinput;
 313 };
 314
 315 struct callback_msg_data
 316 {
 317     client_ptr_t    callback;   /* callback function */
 318     lparam_t        data;       /* user data for callback */
 319     lparam_t        result;     /* message result */
 320 };
 321
 322 struct winevent_msg_data
 323 {
 324     user_handle_t   hook;       /* hook handle */
 325     thread_id_t     tid;        /* thread id */
 326     client_ptr_t    hook_proc;  /* hook proc address */
 327     /* followed by module name if any */
 328 };
 329
 330 typedef union
 331 {
 332     int type;
 333     struct
 334     {
 335         int            type;    /* INPUT_KEYBOARD */
 336         unsigned short vkey;    /* virtual key code */
 337         unsigned short scan;    /* scan code */
 338         unsigned int   flags;   /* event flags */
 339         unsigned int   time;    /* event time */
 340         lparam_t       info;    /* extra info */
 341     } kbd;
 342     struct
 343     {
 344         int            type;    /* INPUT_MOUSE */
 345         int            x;       /* coordinates */
 346         int            y;
 347         unsigned int   data;    /* mouse data */
 348         unsigned int   flags;   /* event flags */
 349         unsigned int   time;    /* event time */
 350         lparam_t       info;    /* extra info */
 351     } mouse;
 352     struct
 353     {
 354         int            type;    /* INPUT_HARDWARE */
 355         unsigned int   msg;     /* message code */
 356         lparam_t       lparam;  /* message param */
 357     } hw;
 358 } hw_input_t;
 359
 360 typedef union
 361 {
 362     unsigned char            bytes[1];   /* raw data for sent messages */
 363     struct hardware_msg_data hardware;
 364     struct callback_msg_data callback;
 365     struct winevent_msg_data winevent;
 366 } message_data_t;
 367
 368 /* structure for console char/attribute info */
 369 typedef struct
 370 {
 371     WCHAR          ch;
 372     unsigned short attr;
 373 } char_info_t;
 374
 375 /* structure returned in filesystem events */
 376 struct filesystem_event
 377 {
 378     int         action;
 379     data_size_t len;
 380     char        name[1];
 381 };
 382
 383 typedef struct
 384 {
 385     unsigned int low_part;
 386     int          high_part;
 387 } luid_t;
 388
 389 #define MAX_ACL_LEN 65535
 390
 391 struct security_descriptor
 392 {
 393     unsigned int control;       /* SE_ flags */
 394     data_size_t  owner_len;
 395     data_size_t  group_len;
 396     data_size_t  sacl_len;
 397     data_size_t  dacl_len;
 398     /* VARARG(owner,SID); */
 399     /* VARARG(group,SID); */
 400     /* VARARG(sacl,ACL); */
 401     /* VARARG(dacl,ACL); */
 402 };
 403
 404 struct object_attributes
 405 {
 406     obj_handle_t rootdir;       /* root directory */
 407     unsigned int attributes;    /* object attributes */
 408     data_size_t  sd_len;        /* length of security_descriptor data. may be 0 */
 409     data_size_t  name_len;      /* length of the name string. may be 0 */
 410     /* VARARG(sd,security_descriptor); */
 411     /* VARARG(name,unicode_str); */
 412 };
 413
 414 struct token_groups
 415 {
 416     unsigned int count;
 417     /* unsigned int attributes[count]; */
 418     /* VARARG(sids,SID); */
 419 };
 420
 421 enum select_op
 422 {
 423     SELECT_NONE,
 424     SELECT_WAIT,
 425     SELECT_WAIT_ALL,
 426     SELECT_SIGNAL_AND_WAIT,
 427     SELECT_KEYED_EVENT_WAIT,
 428     SELECT_KEYED_EVENT_RELEASE
 429 };
 430
 431 typedef union
 432 {
 433     enum select_op op;
 434     struct
 435     {
 436         enum select_op  op;      /* SELECT_WAIT or SELECT_WAIT_ALL */
 437         obj_handle_t    handles[MAXIMUM_WAIT_OBJECTS];
 438     } wait;
 439     struct
 440     {
 441         enum select_op  op;      /* SELECT_SIGNAL_AND_WAIT */
 442         obj_handle_t    wait;
 443         obj_handle_t    signal;  /* must be last in the structure so we can remove it on retries */
 444     } signal_and_wait;
 445     struct
 446     {
 447         enum select_op  op;      /* SELECT_KEYED_EVENT_WAIT or SELECT_KEYED_EVENT_RELEASE */
 448         obj_handle_t    handle;
 449         client_ptr_t    key;
 450     } keyed_event;
 451 } select_op_t;
 452
 453 enum apc_type
 454 {
 455     APC_NONE,
 456     APC_USER,
 457     APC_TIMER,
 458     APC_ASYNC_IO,
 459     APC_VIRTUAL_ALLOC,
 460     APC_VIRTUAL_FREE,
 461     APC_VIRTUAL_QUERY,
 462     APC_VIRTUAL_PROTECT,
 463     APC_VIRTUAL_FLUSH,
 464     APC_VIRTUAL_LOCK,
 465     APC_VIRTUAL_UNLOCK,
 466     APC_MAP_VIEW,
 467     APC_UNMAP_VIEW,
 468     APC_CREATE_THREAD
 469 };
 470
 471 typedef union
 472 {
 473     enum apc_type type;
 474     struct
 475     {
 476         enum apc_type    type;     /* APC_USER */
 477         int              __pad;
 478         client_ptr_t     func;     /* void (__stdcall *func)(ULONG_PTR,ULONG_PTR,ULONG_PTR); */
 479         apc_param_t      args[3];  /* arguments for user function */
 480     } user;
 481     struct
 482     {
 483         enum apc_type    type;     /* APC_TIMER */
 484         int              __pad;
 485         client_ptr_t     func;     /* void (__stdcall *func)(void*, unsigned int, unsigned int); */
 486         timeout_t        time;     /* absolute time of expiration */
 487         client_ptr_t     arg;      /* user argument */
 488     } timer;
 489     struct
 490     {
 491         enum apc_type    type;     /* APC_ASYNC_IO */
 492         unsigned int     status;   /* I/O status */
 493         client_ptr_t     user;     /* user pointer */
 494         client_ptr_t     sb;       /* status block */
 495     } async_io;
 496     struct
 497     {
 498         enum apc_type    type;      /* APC_VIRTUAL_ALLOC */
 499         unsigned int     op_type;   /* type of operation */
 500         client_ptr_t     addr;      /* requested address */
 501         mem_size_t       size;      /* allocation size */
 502         unsigned int     zero_bits; /* allocation alignment */
 503         unsigned int     prot;      /* memory protection flags */
 504     } virtual_alloc;
 505     struct
 506     {
 507         enum apc_type    type;      /* APC_VIRTUAL_FREE */
 508         unsigned int     op_type;   /* type of operation */
 509         client_ptr_t     addr;      /* requested address */
 510         mem_size_t       size;      /* allocation size */
 511     } virtual_free;
 512     struct
 513     {
 514         enum apc_type    type;      /* APC_VIRTUAL_QUERY */
 515         int              __pad;
 516         client_ptr_t     addr;      /* requested address */
 517     } virtual_query;
 518     struct
 519     {
 520         enum apc_type    type;      /* APC_VIRTUAL_PROTECT */
 521         unsigned int     prot;      /* new protection flags */
 522         client_ptr_t     addr;      /* requested address */
 523         mem_size_t       size;      /* requested size */
 524     } virtual_protect;
 525     struct
 526     {
 527         enum apc_type    type;      /* APC_VIRTUAL_FLUSH */
 528         int              __pad;
 529         client_ptr_t     addr;      /* requested address */
 530         mem_size_t       size;      /* requested size */
 531     } virtual_flush;
 532     struct
 533     {
 534         enum apc_type    type;      /* APC_VIRTUAL_LOCK */
 535         int              __pad;
 536         client_ptr_t     addr;      /* requested address */
 537         mem_size_t       size;      /* requested size */
 538     } virtual_lock;
 539     struct
 540     {
 541         enum apc_type    type;      /* APC_VIRTUAL_UNLOCK */
 542         int              __pad;
 543         client_ptr_t     addr;      /* requested address */
 544         mem_size_t       size;      /* requested size */
 545     } virtual_unlock;
 546     struct
 547     {
 548         enum apc_type    type;      /* APC_MAP_VIEW */
 549         obj_handle_t     handle;    /* mapping handle */
 550         client_ptr_t     addr;      /* requested address */
 551         mem_size_t       size;      /* allocation size */
 552         file_pos_t       offset;    /* file offset */
 553         unsigned int     alloc_type;/* allocation type */
 554         unsigned short   zero_bits; /* allocation alignment */
 555         unsigned short   prot;      /* memory protection flags */
 556     } map_view;
 557     struct
 558     {
 559         enum apc_type    type;      /* APC_UNMAP_VIEW */
 560         int              __pad;
 561         client_ptr_t     addr;      /* view address */
 562     } unmap_view;
 563     struct
 564     {
 565         enum apc_type    type;      /* APC_CREATE_THREAD */
 566         int              suspend;   /* suspended thread? */
 567         client_ptr_t     func;      /* void (__stdcall *func)(void*);  start function */
 568         client_ptr_t     arg;       /* argument for start function */
 569         mem_size_t       reserve;   /* reserve size for thread stack */
 570         mem_size_t       commit;    /* commit size for thread stack */
 571     } create_thread;
 572 } apc_call_t;
 573
 574 typedef union
 575 {
 576     enum apc_type type;
 577     struct
 578     {
 579         enum apc_type    type;      /* APC_ASYNC_IO */
 580         unsigned int     status;    /* new status of async operation */
 581         unsigned int     total;     /* bytes transferred */
 582     } async_io;
 583     struct
 584     {
 585         enum apc_type    type;      /* APC_VIRTUAL_ALLOC */
 586         unsigned int     status;    /* status returned by call */
 587         client_ptr_t     addr;      /* resulting address */
 588         mem_size_t       size;      /* resulting size */
 589     } virtual_alloc;
 590     struct
 591     {
 592         enum apc_type    type;      /* APC_VIRTUAL_FREE */
 593         unsigned int     status;    /* status returned by call */
 594         client_ptr_t     addr;      /* resulting address */
 595         mem_size_t       size;      /* resulting size */
 596     } virtual_free;
 597     struct
 598     {
 599         enum apc_type    type;      /* APC_VIRTUAL_QUERY */
 600         unsigned int     status;    /* status returned by call */
 601         client_ptr_t     base;      /* resulting base address */
 602         client_ptr_t     alloc_base;/* resulting allocation base */
 603         mem_size_t       size;      /* resulting region size */
 604         unsigned short   state;     /* resulting region state */
 605         unsigned short   prot;      /* resulting region protection */
 606         unsigned short   alloc_prot;/* resulting allocation protection */
 607         unsigned short   alloc_type;/* resulting region allocation type */
 608     } virtual_query;
 609     struct
 610     {
 611         enum apc_type    type;      /* APC_VIRTUAL_PROTECT */
 612         unsigned int     status;    /* status returned by call */
 613         client_ptr_t     addr;      /* resulting address */
 614         mem_size_t       size;      /* resulting size */
 615         unsigned int     prot;      /* old protection flags */
 616     } virtual_protect;
 617     struct
 618     {
 619         enum apc_type    type;      /* APC_VIRTUAL_FLUSH */
 620         unsigned int     status;    /* status returned by call */
 621         client_ptr_t     addr;      /* resulting address */
 622         mem_size_t       size;      /* resulting size */
 623     } virtual_flush;
 624     struct
 625     {
 626         enum apc_type    type;      /* APC_VIRTUAL_LOCK */
 627         unsigned int     status;    /* status returned by call */
 628         client_ptr_t     addr;      /* resulting address */
 629         mem_size_t       size;      /* resulting size */
 630     } virtual_lock;
 631     struct
 632     {
 633         enum apc_type    type;      /* APC_VIRTUAL_UNLOCK */
 634         unsigned int     status;    /* status returned by call */
 635         client_ptr_t     addr;      /* resulting address */
 636         mem_size_t       size;      /* resulting size */
 637     } virtual_unlock;
 638     struct
 639     {
 640         enum apc_type    type;      /* APC_MAP_VIEW */
 641         unsigned int     status;    /* status returned by call */
 642         client_ptr_t     addr;      /* resulting address */
 643         mem_size_t       size;      /* resulting size */
 644     } map_view;
 645     struct
 646     {
 647         enum apc_type    type;      /* APC_MAP_VIEW */
 648         unsigned int     status;    /* status returned by call */
 649     } unmap_view;
 650     struct
 651     {
 652         enum apc_type    type;      /* APC_CREATE_THREAD */
 653         unsigned int     status;    /* status returned by call */
 654         thread_id_t      tid;       /* thread id */
 655         obj_handle_t     handle;    /* handle to new thread */
 656     } create_thread;
 657 } apc_result_t;
 658
 659 typedef union
 660 {
 661     unsigned int         major;     /* irp major function */
 662     struct
 663     {
 664         unsigned int     major;     /* IRP_MJ_CREATE */
 665         unsigned int     access;    /* access rights */
 666         unsigned int     sharing;   /* sharing flags */
 667         unsigned int     options;   /* file options */
 668         client_ptr_t     device;    /* opaque ptr for the device */
 669     } create;
 670     struct
 671     {
 672         unsigned int     major;     /* IRP_MJ_CLOSE */
 673         int              __pad;
 674         client_ptr_t     file;      /* opaque ptr for the file object */
 675     } close;
 676     struct
 677     {
 678         unsigned int     major;     /* IRP_MJ_READ */
 679         unsigned int     key;       /* driver key */
 680         client_ptr_t     file;      /* opaque ptr for the file object */
 681         file_pos_t       pos;       /* file position */
 682     } read;
 683     struct
 684     {
 685         unsigned int     major;     /* IRP_MJ_WRITE */
 686         unsigned int     key;       /* driver key */
 687         client_ptr_t     file;      /* opaque ptr for the file object */
 688         file_pos_t       pos;       /* file position */
 689     } write;
 690     struct
 691     {
 692         unsigned int     major;     /* IRP_MJ_FLUSH_BUFFERS */
 693         int              __pad;
 694         client_ptr_t     file;      /* opaque ptr for the file object */
 695     } flush;
 696     struct
 697     {
 698         unsigned int     major;     /* IRP_MJ_DEVICE_CONTROL */
 699         ioctl_code_t     code;      /* ioctl code */
 700         client_ptr_t     file;      /* opaque ptr for the file object */
 701     } ioctl;
 702 } irp_params_t;
 703
 704 /* information about a PE image mapping, roughly equivalent to SECTION_IMAGE_INFORMATION */
 705 typedef struct
 706 {
 707     client_ptr_t   base;
 708     client_ptr_t   entry_point;
 709     mem_size_t     map_size;
 710     mem_size_t     stack_size;
 711     mem_size_t     stack_commit;
 712     unsigned int   zerobits;
 713     unsigned int   subsystem;
 714     unsigned short subsystem_low;
 715     unsigned short subsystem_high;
 716     unsigned int   gp;
 717     unsigned short image_charact;
 718     unsigned short dll_charact;
 719     unsigned short machine;
 720     unsigned char  contains_code;
 721     unsigned char  image_flags;
 722     unsigned int   loader_flags;
 723     unsigned int   header_size;
 724     unsigned int   file_size;
 725     unsigned int   checksum;
 726     cpu_type_t     cpu;
 727 } pe_image_info_t;
 728 #define IMAGE_FLAGS_ComPlusNativeReady        0x01
 729 #define IMAGE_FLAGS_ComPlusILOnly             0x02
 730 #define IMAGE_FLAGS_ImageDynamicallyRelocated 0x04
 731 #define IMAGE_FLAGS_ImageMappedFlat           0x08
 732 #define IMAGE_FLAGS_BaseBelow4gb              0x10
 733 #define IMAGE_FLAGS_WineFakeDll               0x80
 734
 735 struct rawinput_device
 736 {
 737     unsigned short usage_page;
 738     unsigned short usage;
 739     unsigned int   flags;
 740     user_handle_t  target;
 741 };
 742
 743 /****************************************************************/
 744 /* Request declarations */
 745
 746 /* Create a new process from the context of the parent */
 747 @REQ(new_process)
 748     int          inherit_all;    /* inherit all handles from parent */
 749     unsigned int create_flags;   /* creation flags */
 750     int          socket_fd;      /* file descriptor for process socket */
 751     obj_handle_t exe_file;       /* file handle for main exe */
 752     unsigned int access;         /* access rights for process object */
 753     cpu_type_t   cpu;            /* CPU that the new process will use */
 754     data_size_t  info_size;      /* size of startup info */
 755     VARARG(objattr,object_attributes);   /* object attributes */
 756     VARARG(info,startup_info,info_size); /* startup information */
 757     VARARG(env,unicode_str);     /* environment for new process */
 758 @REPLY
 759     obj_handle_t info;           /* new process info handle */
 760     process_id_t pid;            /* process id */
 761     obj_handle_t handle;         /* process handle (in the current process) */
 762 @END
 763
 764
 765 /* Execute a process, replacing the current one */
 766 @REQ(exec_process)
 767     int          socket_fd;      /* file descriptor for process socket */
 768     obj_handle_t exe_file;       /* file handle for main exe */
 769     cpu_type_t   cpu;            /* CPU that the new process will use */
 770 @END
 771
 772
 773 /* Retrieve information about a newly started process */
 774 @REQ(get_new_process_info)
 775     obj_handle_t info;           /* info handle returned from new_process_request */
 776 @REPLY
 777     int          success;      /* did the process start successfully? */
 778     int          exit_code;    /* process exit code if failed */
 779 @END
 780
 781
 782 /* Create a new thread */
 783 @REQ(new_thread)
 784     obj_handle_t process;      /* process in which to create thread */
 785     unsigned int access;       /* wanted access rights */
 786     int          suspend;      /* new thread should be suspended on creation */
 787     int          request_fd;   /* fd for request pipe */
 788     VARARG(objattr,object_attributes); /* object attributes */
 789 @REPLY
 790     thread_id_t  tid;          /* thread id */
 791     obj_handle_t handle;       /* thread handle (in the current process) */
 792 @END
 793
 794
 795 /* Retrieve the new process startup info */
 796 @REQ(get_startup_info)
 797 @REPLY
 798     data_size_t  info_size;    /* size of startup info */
 799     VARARG(info,startup_info,info_size); /* startup information */
 800     VARARG(env,unicode_str);   /* environment */
 801 @END
 802
 803
 804 /* Signal the end of the process initialization */
 805 @REQ(init_process_done)
 806     int          gui;          /* is it a GUI process? */
 807     mod_handle_t module;       /* main module base address */
 808     client_ptr_t ldt_copy;     /* address of LDT copy (in thread address space) */
 809     client_ptr_t entry;        /* process entry point */
 810 @REPLY
 811     int          suspend;      /* is process suspended? */
 812 @END
 813
 814
 815 /* Initialize a thread; called from the child after fork()/clone() */
 816 @REQ(init_thread)
 817     int          unix_pid;     /* Unix pid of new thread */
 818     int          unix_tid;     /* Unix tid of new thread */
 819     int          debug_level;  /* new debug level */
 820     client_ptr_t teb;          /* TEB of new thread (in thread address space) */
 821     client_ptr_t entry;        /* entry point or PEB if initial thread (in thread address space) */
 822     int          reply_fd;     /* fd for reply pipe */
 823     int          wait_fd;      /* fd for blocking calls pipe */
 824     cpu_type_t   cpu;          /* CPU that this thread is running on */
 825 @REPLY
 826     process_id_t pid;          /* process id of the new thread's process */
 827     thread_id_t  tid;          /* thread id of the new thread */
 828     timeout_t    server_start; /* server start time */
 829     data_size_t  info_size;    /* total size of startup info */
 830     int          version;      /* protocol version */
 831     unsigned int all_cpus;     /* bitset of supported CPUs */
 832     int          suspend;      /* is thread suspended? */
 833 @END
 834
 835
 836 /* Terminate a process */
 837 @REQ(terminate_process)
 838     obj_handle_t handle;       /* process handle to terminate */
 839     int          exit_code;    /* process exit code */
 840 @REPLY
 841     int          self;         /* suicide? */
 842 @END
 843
 844
 845 /* Terminate a thread */
 846 @REQ(terminate_thread)
 847     obj_handle_t handle;       /* thread handle to terminate */
 848     int          exit_code;    /* thread exit code */
 849 @REPLY
 850     int          self;         /* suicide? */
 851     int          last;         /* last thread in this process? */
 852 @END
 853
 854
 855 /* Retrieve information about a process */
 856 @REQ(get_process_info)
 857     obj_handle_t handle;           /* process handle */
 858 @REPLY
 859     process_id_t pid;              /* server process id */
 860     process_id_t ppid;             /* server process id of parent */
 861     affinity_t   affinity;         /* process affinity mask */
 862     client_ptr_t peb;              /* PEB address in process address space */
 863     timeout_t    start_time;       /* process start time */
 864     timeout_t    end_time;         /* process end time */
 865     int          exit_code;        /* process exit code */
 866     int          priority;         /* priority class */
 867     cpu_type_t   cpu;              /* CPU that this process is running on */
 868     short int    debugger_present; /* process is being debugged */
 869     short int    debug_children;   /* inherit debugger to child processes */
 870 @END
 871
 872
 873 /* Retrieve information about a process memory usage */
 874 @REQ(get_process_vm_counters)
 875     obj_handle_t handle;                        /* process handle */
 876 @REPLY
 877     mem_size_t peak_virtual_size;               /* peak virtual memory in bytes */
 878     mem_size_t virtual_size;                    /* virtual memory in bytes */
 879     mem_size_t peak_working_set_size;           /* peak real memory in bytes */
 880     mem_size_t working_set_size;                /* real memory in bytes */
 881     mem_size_t pagefile_usage;                  /* commit charge in bytes */
 882     mem_size_t peak_pagefile_usage;             /* peak commit charge in bytes */
 883 @END
 884
 885
 886 /* Set a process information */
 887 @REQ(set_process_info)
 888     obj_handle_t handle;       /* process handle */
 889     int          mask;         /* setting mask (see below) */
 890     int          priority;     /* priority class */
 891     affinity_t   affinity;     /* affinity mask */
 892 @END
 893 #define SET_PROCESS_INFO_PRIORITY 0x01
 894 #define SET_PROCESS_INFO_AFFINITY 0x02
 895
 896
 897 /* Retrieve information about a thread */
 898 @REQ(get_thread_info)
 899     obj_handle_t handle;        /* thread handle */
 900     thread_id_t  tid_in;        /* thread id (optional) */
 901 @REPLY
 902     process_id_t pid;           /* server process id */
 903     thread_id_t  tid;           /* server thread id */
 904     client_ptr_t teb;           /* thread teb pointer */
 905     client_ptr_t entry_point;   /* thread entry point */
 906     affinity_t   affinity;      /* thread affinity mask */
 907     int          exit_code;     /* thread exit code */
 908     int          priority;      /* thread priority level */
 909     int          last;          /* last thread in process */
 910 @END
 911
 912
 913 /* Retrieve information about thread times */
 914 @REQ(get_thread_times)
 915     obj_handle_t handle;        /* thread handle */
 916 @REPLY
 917     timeout_t    creation_time; /* thread creation time */
 918     timeout_t    exit_time;     /* thread exit time */
 919 @END
 920
 921
 922 /* Set a thread information */
 923 @REQ(set_thread_info)
 924     obj_handle_t handle;       /* thread handle */
 925     int          mask;         /* setting mask (see below) */
 926     int          priority;     /* priority class */
 927     affinity_t   affinity;     /* affinity mask */
 928     client_ptr_t entry_point;  /* thread entry point */
 929     obj_handle_t token;        /* impersonation token */
 930 @END
 931 #define SET_THREAD_INFO_PRIORITY   0x01
 932 #define SET_THREAD_INFO_AFFINITY   0x02
 933 #define SET_THREAD_INFO_TOKEN      0x04
 934 #define SET_THREAD_INFO_ENTRYPOINT 0x08
 935
 936
 937 /* Retrieve information about a module */
 938 @REQ(get_dll_info)
 939     obj_handle_t handle;       /* process handle */
 940     mod_handle_t base_address; /* base address of module */
 941 @REPLY
 942     client_ptr_t entry_point;
 943     data_size_t  filename_len;    /* buffer len in bytes required to store filename */
 944     VARARG(filename,unicode_str); /* file name of module */
 945 @END
 946
 947
 948 /* Suspend a thread */
 949 @REQ(suspend_thread)
 950     obj_handle_t handle;       /* thread handle */
 951 @REPLY
 952     int          count;        /* new suspend count */
 953 @END
 954
 955
 956 /* Resume a thread */
 957 @REQ(resume_thread)
 958     obj_handle_t handle;       /* thread handle */
 959 @REPLY
 960     int          count;        /* new suspend count */
 961 @END
 962
 963
 964 /* Notify the server that a dll has been loaded */
 965 @REQ(load_dll)
 966     data_size_t  dbg_offset;   /* debug info offset */
 967     mod_handle_t base;         /* base address */
 968     client_ptr_t name;         /* ptr to ptr to name (in process addr space) */
 969     data_size_t  dbg_size;     /* debug info size */
 970     VARARG(filename,unicode_str); /* file name of dll */
 971 @END
 972
 973
 974 /* Notify the server that a dll is being unloaded */
 975 @REQ(unload_dll)
 976     mod_handle_t base;         /* base address */
 977 @END
 978
 979
 980 /* Queue an APC for a thread or process */
 981 @REQ(queue_apc)
 982     obj_handle_t handle;       /* thread or process handle */
 983     apc_call_t   call;         /* call arguments */
 984 @REPLY
 985     obj_handle_t handle;       /* APC handle */
 986     int          self;         /* run APC in caller itself? */
 987 @END
 988
 989
 990 /* Get the result of an APC call */
 991 @REQ(get_apc_result)
 992     obj_handle_t handle;       /* handle to the APC */
 993 @REPLY
 994     apc_result_t result;       /* result of the APC */
 995 @END
 996
 997
 998 /* Close a handle for the current process */
 999 @REQ(close_handle)
1000     obj_handle_t handle;       /* handle to close */
1001 @END
1002
1003
1004 /* Set a handle information */
1005 @REQ(set_handle_info)
1006     obj_handle_t handle;       /* handle we are interested in */
1007     int          flags;        /* new handle flags */
1008     int          mask;         /* mask for flags to set */
1009 @REPLY
1010     int          old_flags;    /* old flag value */
1011 @END
1012
1013
1014 /* Duplicate a handle */
1015 @REQ(dup_handle)
1016     obj_handle_t src_process;  /* src process handle */
1017     obj_handle_t src_handle;   /* src handle to duplicate */
1018     obj_handle_t dst_process;  /* dst process handle */
1019     unsigned int access;       /* wanted access rights */
1020     unsigned int attributes;   /* object attributes */
1021     unsigned int options;      /* duplicate options (see below) */
1022 @REPLY
1023     obj_handle_t handle;       /* duplicated handle in dst process */
1024     int          self;         /* is the source the current process? */
1025     int          closed;       /* whether the source handle has been closed */
1026 @END
1027 #define DUP_HANDLE_CLOSE_SOURCE  DUPLICATE_CLOSE_SOURCE
1028 #define DUP_HANDLE_SAME_ACCESS   DUPLICATE_SAME_ACCESS
1029 #define DUP_HANDLE_MAKE_GLOBAL   0x80000000  /* Not a Windows flag */
1030
1031
1032 /* Open a handle to a process */
1033 @REQ(open_process)
1034     process_id_t pid;          /* process id to open */
1035     unsigned int access;       /* wanted access rights */
1036     unsigned int attributes;   /* object attributes */
1037 @REPLY
1038     obj_handle_t handle;       /* handle to the process */
1039 @END
1040
1041
1042 /* Open a handle to a thread */
1043 @REQ(open_thread)
1044     thread_id_t  tid;          /* thread id to open */
1045     unsigned int access;       /* wanted access rights */
1046     unsigned int attributes;   /* object attributes */
1047 @REPLY
1048     obj_handle_t handle;       /* handle to the thread */
1049 @END
1050
1051
1052 /* Wait for handles */
1053 @REQ(select)
1054     int          flags;        /* wait flags (see below) */
1055     client_ptr_t cookie;       /* magic cookie to return to client */
1056     timeout_t    timeout;      /* timeout */
1057     obj_handle_t prev_apc;     /* handle to previous APC */
1058     VARARG(result,apc_result); /* result of previous APC */
1059     VARARG(data,select_op);    /* operation-specific data */
1060 @REPLY
1061     timeout_t    timeout;      /* timeout converted to absolute */
1062     apc_call_t   call;         /* APC call arguments */
1063     obj_handle_t apc_handle;   /* handle to next APC */
1064 @END
1065 #define SELECT_ALERTABLE     1
1066 #define SELECT_INTERRUPTIBLE 2
1067
1068
1069 /* Create an event */
1070 @REQ(create_event)
1071     unsigned int access;        /* wanted access rights */
1072     int          manual_reset;  /* manual reset event */
1073     int          initial_state; /* initial state of the event */
1074     VARARG(objattr,object_attributes); /* object attributes */
1075 @REPLY
1076     obj_handle_t handle;        /* handle to the event */
1077 @END
1078
1079 /* Event operation */
1080 @REQ(event_op)
1081     obj_handle_t  handle;       /* handle to event */
1082     int           op;           /* event operation (see below) */
1083 @REPLY
1084     int           state;        /* previous state */
1085 @END
1086 enum event_op { PULSE_EVENT, SET_EVENT, RESET_EVENT };
1087
1088 @REQ(query_event)
1089     obj_handle_t  handle;       /* handle to event */
1090 @REPLY
1091     int          manual_reset;  /* manual reset event */
1092     int          state;         /* current state of the event */
1093 @END
1094
1095 /* Open an event */
1096 @REQ(open_event)
1097     unsigned int access;        /* wanted access rights */
1098     unsigned int attributes;    /* object attributes */
1099     obj_handle_t rootdir;       /* root directory */
1100     VARARG(name,unicode_str);   /* object name */
1101 @REPLY
1102     obj_handle_t handle;        /* handle to the event */
1103 @END
1104
1105
1106 /* Create a keyed event */
1107 @REQ(create_keyed_event)
1108     unsigned int access;        /* wanted access rights */
1109     VARARG(objattr,object_attributes); /* object attributes */
1110 @REPLY
1111     obj_handle_t handle;        /* handle to the event */
1112 @END
1113
1114 /* Open a keyed event */
1115 @REQ(open_keyed_event)
1116     unsigned int access;        /* wanted access rights */
1117     unsigned int attributes;    /* object attributes */
1118     obj_handle_t rootdir;       /* root directory */
1119     VARARG(name,unicode_str);   /* object name */
1120 @REPLY
1121     obj_handle_t handle;        /* handle to the event */
1122 @END
1123
1124
1125 /* Create a mutex */
1126 @REQ(create_mutex)
1127     unsigned int access;        /* wanted access rights */
1128     int          owned;         /* initially owned? */
1129     VARARG(objattr,object_attributes); /* object attributes */
1130 @REPLY
1131     obj_handle_t handle;        /* handle to the mutex */
1132 @END
1133
1134
1135 /* Release a mutex */
1136 @REQ(release_mutex)
1137     obj_handle_t handle;        /* handle to the mutex */
1138 @REPLY
1139     unsigned int prev_count;    /* value of internal counter, before release */
1140 @END
1141
1142
1143 /* Open a mutex */
1144 @REQ(open_mutex)
1145     unsigned int access;        /* wanted access rights */
1146     unsigned int attributes;    /* object attributes */
1147     obj_handle_t rootdir;       /* root directory */
1148     VARARG(name,unicode_str);   /* object name */
1149 @REPLY
1150     obj_handle_t handle;        /* handle to the mutex */
1151 @END
1152
1153
1154 /* Query a mutex */
1155 @REQ(query_mutex)
1156     obj_handle_t  handle;       /* handle to mutex */
1157 @REPLY
1158     unsigned int count;         /* current count of mutex */
1159     int          owned;         /* true if owned by current thread */
1160     int          abandoned;     /* true if abandoned */
1161 @END
1162
1163
1164 /* Create a semaphore */
1165 @REQ(create_semaphore)
1166     unsigned int access;        /* wanted access rights */
1167     unsigned int initial;       /* initial count */
1168     unsigned int max;           /* maximum count */
1169     VARARG(objattr,object_attributes); /* object attributes */
1170 @REPLY
1171     obj_handle_t handle;        /* handle to the semaphore */
1172 @END
1173
1174
1175 /* Release a semaphore */
1176 @REQ(release_semaphore)
1177     obj_handle_t handle;        /* handle to the semaphore */
1178     unsigned int count;         /* count to add to semaphore */
1179 @REPLY
1180     unsigned int prev_count;    /* previous semaphore count */
1181 @END
1182
1183 @REQ(query_semaphore)
1184     obj_handle_t handle;       /* handle to the semaphore */
1185 @REPLY
1186     unsigned int current;      /* current count */
1187     unsigned int max;          /* maximum count */
1188 @END
1189
1190 /* Open a semaphore */
1191 @REQ(open_semaphore)
1192     unsigned int access;        /* wanted access rights */
1193     unsigned int attributes;    /* object attributes */
1194     obj_handle_t rootdir;       /* root directory */
1195     VARARG(name,unicode_str);   /* object name */
1196 @REPLY
1197     obj_handle_t handle;        /* handle to the semaphore */
1198 @END
1199
1200
1201 /* Create a file */
1202 @REQ(create_file)
1203     unsigned int access;        /* wanted access rights */
1204     unsigned int sharing;       /* sharing flags */
1205     int          create;        /* file create action */
1206     unsigned int options;       /* file options */
1207     unsigned int attrs;         /* file attributes for creation */
1208     VARARG(objattr,object_attributes); /* object attributes */
1209     VARARG(filename,string);    /* file name */
1210 @REPLY
1211     obj_handle_t handle;        /* handle to the file */
1212 @END
1213
1214
1215 /* Open a file object */
1216 @REQ(open_file_object)
1217     unsigned int access;        /* wanted access rights */
1218     unsigned int attributes;    /* open attributes */
1219     obj_handle_t rootdir;       /* root directory */
1220     unsigned int sharing;       /* sharing flags */
1221     unsigned int options;       /* file options */
1222     VARARG(filename,unicode_str); /* file name */
1223 @REPLY
1224     obj_handle_t handle;        /* handle to the file */
1225 @END
1226
1227
1228 /* Allocate a file handle for a Unix fd */
1229 @REQ(alloc_file_handle)
1230     unsigned int access;        /* wanted access rights */
1231     unsigned int attributes;    /* object attributes */
1232     int          fd;            /* file descriptor on the client side */
1233 @REPLY
1234     obj_handle_t handle;        /* handle to the file */
1235 @END
1236
1237
1238 /* Get the Unix name from a file handle */
1239 @REQ(get_handle_unix_name)
1240     obj_handle_t   handle;      /* file handle */
1241 @REPLY
1242     data_size_t    name_len;    /* unix name length */
1243     VARARG(name,string);        /* unix name */
1244 @END
1245
1246
1247 /* Get a Unix fd to access a file */
1248 @REQ(get_handle_fd)
1249     obj_handle_t handle;        /* handle to the file */
1250 @REPLY
1251     int          type;          /* file type (see below) */
1252     int          cacheable;     /* can fd be cached in the client? */
1253     unsigned int access;        /* file access rights */
1254     unsigned int options;       /* file open options */
1255 @END
1256 enum server_fd_type
1257 {
1258     FD_TYPE_INVALID,  /* invalid file (no associated fd) */
1259     FD_TYPE_FILE,     /* regular file */
1260     FD_TYPE_DIR,      /* directory */
1261     FD_TYPE_SOCKET,   /* socket */
1262     FD_TYPE_SERIAL,   /* serial port */
1263     FD_TYPE_PIPE,     /* named pipe */
1264     FD_TYPE_MAILSLOT, /* mailslot */
1265     FD_TYPE_CHAR,     /* unspecified char device */
1266     FD_TYPE_DEVICE,   /* Windows device file */
1267     FD_TYPE_NB_TYPES
1268 };
1269
1270
1271 /* Retrieve (or allocate) the client-side directory cache entry */
1272 @REQ(get_directory_cache_entry)
1273     obj_handle_t handle;        /* handle to the directory */
1274 @REPLY
1275     int          entry;         /* cache entry on the client side */
1276     VARARG(free,ints);          /* entries that can be freed */
1277 @END
1278
1279
1280 /* Flush a file buffers */
1281 @REQ(flush)
1282     async_data_t   async;       /* async I/O parameters */
1283 @REPLY
1284     obj_handle_t event;         /* event set when finished */
1285 @END
1286
1287 /* Query file information */
1288 @REQ(get_file_info)
1289     obj_handle_t handle;        /* handle to the file */
1290     unsigned int info_class;    /* queried information class */
1291 @REPLY
1292     VARARG(data,bytes);         /* file info data */
1293 @END
1294
1295 /* Query volume information */
1296 @REQ(get_volume_info)
1297     obj_handle_t handle;        /* handle to the file */
1298     unsigned int info_class;    /* queried information class */
1299 @REPLY
1300     VARARG(data,bytes);         /* volume info data */
1301 @END
1302
1303 /* Lock a region of a file */
1304 @REQ(lock_file)
1305     obj_handle_t handle;        /* handle to the file */
1306     file_pos_t   offset;        /* offset of start of lock */
1307     file_pos_t   count;         /* count of bytes to lock */
1308     int          shared;        /* shared or exclusive lock? */
1309     int          wait;          /* do we want to wait? */
1310 @REPLY
1311     obj_handle_t handle;        /* handle to wait on */
1312     int          overlapped;    /* is it an overlapped I/O handle? */
1313 @END
1314
1315
1316 /* Unlock a region of a file */
1317 @REQ(unlock_file)
1318     obj_handle_t handle;        /* handle to the file */
1319     file_pos_t   offset;        /* offset of start of unlock */
1320     file_pos_t   count;         /* count of bytes to unlock */
1321 @END
1322
1323
1324 /* Create a socket */
1325 @REQ(create_socket)
1326     unsigned int access;        /* wanted access rights */
1327     unsigned int attributes;    /* object attributes */
1328     int          family;        /* family, see socket manpage */
1329     int          type;          /* type, see socket manpage */
1330     int          protocol;      /* protocol, see socket manpage */
1331     unsigned int flags;         /* socket flags */
1332 @REPLY
1333     obj_handle_t handle;        /* handle to the new socket */
1334 @END
1335
1336
1337 /* Accept a socket */
1338 @REQ(accept_socket)
1339     obj_handle_t lhandle;       /* handle to the listening socket */
1340     unsigned int access;        /* wanted access rights */
1341     unsigned int attributes;    /* object attributes */
1342 @REPLY
1343     obj_handle_t handle;        /* handle to the new socket */
1344 @END
1345
1346
1347 /* Accept into an initialized socket */
1348 @REQ(accept_into_socket)
1349     obj_handle_t lhandle;       /* handle to the listening socket */
1350     obj_handle_t ahandle;       /* handle to the accepting socket */
1351 @END
1352
1353
1354 /* Set socket event parameters */
1355 @REQ(set_socket_event)
1356     obj_handle_t  handle;        /* handle to the socket */
1357     unsigned int  mask;          /* event mask */
1358     obj_handle_t  event;         /* event object */
1359     user_handle_t window;        /* window to send the message to */
1360     unsigned int  msg;           /* message to send */
1361 @END
1362
1363
1364 /* Get socket event parameters */
1365 @REQ(get_socket_event)
1366     obj_handle_t handle;        /* handle to the socket */
1367     int          service;       /* clear pending? */
1368     obj_handle_t c_event;       /* event to clear */
1369 @REPLY
1370     unsigned int mask;          /* event mask */
1371     unsigned int pmask;         /* pending events */
1372     unsigned int state;         /* status bits */
1373     VARARG(errors,ints);        /* event errors */
1374 @END
1375
1376
1377 /* Get socket info */
1378 @REQ(get_socket_info)
1379     obj_handle_t handle;        /* handle to the socket */
1380 @REPLY
1381     int family;                 /* family, see socket manpage */
1382     int type;                   /* type, see socket manpage */
1383     int protocol;               /* protocol, see socket manpage */
1384 @END
1385
1386
1387 /* Re-enable pending socket events */
1388 @REQ(enable_socket_event)
1389     obj_handle_t handle;        /* handle to the socket */
1390     unsigned int mask;          /* events to re-enable */
1391     unsigned int sstate;        /* status bits to set */
1392     unsigned int cstate;        /* status bits to clear */
1393 @END
1394
1395 @REQ(set_socket_deferred)
1396     obj_handle_t handle;        /* handle to the socket */
1397     obj_handle_t deferred;      /* handle to the socket for which accept() is deferred */
1398 @END
1399
1400 /* Allocate a console (only used by a console renderer) */
1401 @REQ(alloc_console)
1402     unsigned int access;        /* wanted access rights */
1403     unsigned int attributes;    /* object attributes */
1404     process_id_t pid;           /* pid of process which shall be attached to the console */
1405     int          input_fd;      /* if pid=-1 (bare console to current process), fd for input */
1406 @REPLY
1407     obj_handle_t handle_in;     /* handle to console input */
1408     obj_handle_t event;         /* handle to renderer events change notification */
1409 @END
1410
1411
1412 /* Free the console of the current process */
1413 @REQ(free_console)
1414 @END
1415
1416
1417 #define CONSOLE_RENDERER_NONE_EVENT        0x00
1418 #define CONSOLE_RENDERER_TITLE_EVENT       0x01
1419 #define CONSOLE_RENDERER_ACTIVE_SB_EVENT   0x02
1420 #define CONSOLE_RENDERER_SB_RESIZE_EVENT   0x03
1421 #define CONSOLE_RENDERER_UPDATE_EVENT      0x04
1422 #define CONSOLE_RENDERER_CURSOR_POS_EVENT  0x05
1423 #define CONSOLE_RENDERER_CURSOR_GEOM_EVENT 0x06
1424 #define CONSOLE_RENDERER_DISPLAY_EVENT     0x07
1425 #define CONSOLE_RENDERER_EXIT_EVENT        0x08
1426 struct console_renderer_event
1427 {
1428     short event;
1429     union
1430     {
1431         struct
1432         {
1433             short top;
1434             short bottom;
1435         } update;
1436         struct
1437         {
1438             short width;
1439             short height;
1440         } resize;
1441         struct
1442         {
1443             short x;
1444             short y;
1445         } cursor_pos;
1446         struct
1447         {
1448             short visible;
1449             short size;
1450         } cursor_geom;
1451         struct
1452         {
1453             short left;
1454             short top;
1455             short width;
1456             short height;
1457         } display;
1458     } u;
1459 };
1460
1461 /* retrieve console events for the renderer */
1462 @REQ(get_console_renderer_events)
1463     obj_handle_t handle;        /* handle to console input events */
1464 @REPLY
1465     VARARG(data,bytes);         /* the various console_renderer_events */
1466 @END
1467
1468
1469 /* Open a handle to the process console */
1470 @REQ(open_console)
1471     obj_handle_t from;          /* 0 (resp 1) input (resp output) of current process console */
1472                                 /* otherwise console_in handle to get active screen buffer? */
1473     unsigned int access;        /* wanted access rights */
1474     unsigned int attributes;    /* object attributes */
1475     int          share;         /* share mask (only for output handles) */
1476 @REPLY
1477     obj_handle_t handle;        /* handle to the console */
1478 @END
1479
1480
1481 /* Attach to a other process's console */
1482 @REQ(attach_console)
1483     process_id_t pid;           /* pid of attached console process */
1484 @REPLY
1485     obj_handle_t std_in;        /* attached stdin */
1486     obj_handle_t std_out;       /* attached stdout */
1487     obj_handle_t std_err;       /* attached stderr */
1488 @END
1489
1490
1491 /* Get the input queue wait event */
1492 @REQ(get_console_wait_event)
1493 @REPLY
1494     obj_handle_t handle;
1495 @END
1496
1497 /* Get a console mode (input or output) */
1498 @REQ(get_console_mode)
1499     obj_handle_t handle;        /* handle to the console */
1500 @REPLY
1501     int          mode;          /* console mode */
1502 @END
1503
1504
1505 /* Set a console mode (input or output) */
1506 @REQ(set_console_mode)
1507     obj_handle_t handle;        /* handle to the console */
1508     int          mode;          /* console mode */
1509 @END
1510
1511
1512 /* Set info about a console (input only) */
1513 @REQ(set_console_input_info)
1514     obj_handle_t  handle;        /* handle to console input, or 0 for process' console */
1515     int           mask;          /* setting mask (see below) */
1516     obj_handle_t  active_sb;     /* active screen buffer */
1517     int           history_mode;  /* whether we duplicate lines in history */
1518     int           history_size;  /* number of lines in history */
1519     int           edition_mode;  /* index to the edition mode flavors */
1520     int           input_cp;      /* console input codepage */
1521     int           output_cp;     /* console output codepage */
1522     user_handle_t win;           /* console window if backend supports it */
1523     VARARG(title,unicode_str);   /* console title */
1524 @END
1525 #define SET_CONSOLE_INPUT_INFO_ACTIVE_SB        0x01
1526 #define SET_CONSOLE_INPUT_INFO_TITLE            0x02
1527 #define SET_CONSOLE_INPUT_INFO_HISTORY_MODE     0x04
1528 #define SET_CONSOLE_INPUT_INFO_HISTORY_SIZE     0x08
1529 #define SET_CONSOLE_INPUT_INFO_EDITION_MODE     0x10
1530 #define SET_CONSOLE_INPUT_INFO_INPUT_CODEPAGE   0x20
1531 #define SET_CONSOLE_INPUT_INFO_OUTPUT_CODEPAGE  0x40
1532 #define SET_CONSOLE_INPUT_INFO_WIN              0x80
1533
1534
1535 /* Get info about a console (input only) */
1536 @REQ(get_console_input_info)
1537     obj_handle_t  handle;         /* handle to console input, or 0 for process' console */
1538 @REPLY
1539     int           history_mode;   /* whether we duplicate lines in history */
1540     int           history_size;   /* number of lines in history */
1541     int           history_index;  /* number of used lines in history */
1542     int           edition_mode;   /* index to the edition mode flavors */
1543     int           input_cp;       /* console input codepage */
1544     int           output_cp;      /* console output codepage */
1545     user_handle_t win;            /* console window if backend supports it */
1546     VARARG(title,unicode_str);    /* console title */
1547 @END
1548
1549
1550 /* appends a string to console's history */
1551 @REQ(append_console_input_history)
1552     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
1553     VARARG(line,unicode_str);   /* line to add */
1554 @END
1555
1556
1557 /* appends a string to console's history */
1558 @REQ(get_console_input_history)
1559     obj_handle_t handle;        /* handle to console input, or 0 for process' console */
1560     int          index;         /* index to get line from */
1561 @REPLY
1562     int          total;         /* total length of line in Unicode chars */
1563     VARARG(line,unicode_str);   /* line to add */
1564 @END
1565
1566
1567 /* creates a new screen buffer on process' console */
1568 @REQ(create_console_output)
1569     obj_handle_t handle_in;     /* handle to console input, or 0 for process' console */
1570     unsigned int access;        /* wanted access rights */
1571     unsigned int attributes;    /* object attributes */
1572     unsigned int share;         /* sharing credentials */
1573     int          fd;            /* for bare consoles, fd the screen-buffer is attached to */
1574 @REPLY
1575     obj_handle_t handle_out;    /* handle to the screen buffer */
1576 @END
1577
1578
1579 /* Set info about a console (output only) */
1580 @REQ(set_console_output_info)
1581     obj_handle_t handle;        /* handle to the console */
1582     int          mask;          /* setting mask (see below) */
1583     short int    cursor_size;   /* size of cursor (percentage filled) */
1584     short int    cursor_visible;/* cursor visibility flag */
1585     short int    cursor_x;      /* position of cursor (x, y) */
1586     short int    cursor_y;
1587     short int    width;         /* width of the screen buffer */
1588     short int    height;        /* height of the screen buffer */
1589     short int    attr;          /* default fill attributes (screen colors) */
1590     short int    popup_attr;    /* pop-up color attributes */
1591     short int    win_left;      /* window actually displayed by renderer */
1592     short int    win_top;       /* the rect area is expressed within the */
1593     short int    win_right;     /* boundaries of the screen buffer */
1594     short int    win_bottom;
1595     short int    max_width;     /* maximum size (width x height) for the window */
1596     short int    max_height;
1597     short int    font_width;    /* font size (width x height) */
1598     short int    font_height;
1599     VARARG(colors,uints);       /* color table */
1600 @END
1601 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_GEOM     0x0001
1602 #define SET_CONSOLE_OUTPUT_INFO_CURSOR_POS      0x0002
1603 #define SET_CONSOLE_OUTPUT_INFO_SIZE            0x0004
1604 #define SET_CONSOLE_OUTPUT_INFO_ATTR            0x0008
1605 #define SET_CONSOLE_OUTPUT_INFO_DISPLAY_WINDOW  0x0010
1606 #define SET_CONSOLE_OUTPUT_INFO_MAX_SIZE        0x0020
1607 #define SET_CONSOLE_OUTPUT_INFO_FONT            0x0040
1608 #define SET_CONSOLE_OUTPUT_INFO_COLORTABLE      0x0080
1609 #define SET_CONSOLE_OUTPUT_INFO_POPUP_ATTR      0x0100
1610
1611
1612 /* Get info about a console (output only) */
1613 @REQ(get_console_output_info)
1614     obj_handle_t handle;        /* handle to the console */
1615 @REPLY
1616     short int    cursor_size;   /* size of cursor (percentage filled) */
1617     short int    cursor_visible;/* cursor visibility flag */
1618     short int    cursor_x;      /* position of cursor (x, y) */
1619     short int    cursor_y;
1620     short int    width;         /* width of the screen buffer */
1621     short int    height;        /* height of the screen buffer */
1622     short int    attr;          /* default fill attributes (screen colors) */
1623     short int    popup_attr;    /* pop-up color attributes */
1624     short int    win_left;      /* window actually displayed by renderer */
1625     short int    win_top;       /* the rect area is expressed within the */
1626     short int    win_right;     /* boundaries of the screen buffer */
1627     short int    win_bottom;
1628     short int    max_width;     /* maximum size (width x height) for the window */
1629     short int    max_height;
1630     short int    font_width;    /* font size (width x height) */
1631     short int    font_height;
1632     VARARG(colors,uints);       /* color table */
1633 @END
1634
1635 /* Add input records to a console input queue */
1636 @REQ(write_console_input)
1637     obj_handle_t handle;        /* handle to the console input */
1638     VARARG(rec,input_records);  /* input records */
1639 @REPLY
1640     int          written;       /* number of records written */
1641 @END
1642
1643
1644 /* Fetch input records from a console input queue */
1645 @REQ(read_console_input)
1646     obj_handle_t handle;        /* handle to the console input */
1647     int          flush;         /* flush the retrieved records from the queue? */
1648 @REPLY
1649     int          read;          /* number of records read */
1650     VARARG(rec,input_records);  /* input records */
1651 @END
1652
1653
1654 /* write data (chars and/or attributes) in a screen buffer */
1655 @REQ(write_console_output)
1656     obj_handle_t handle;        /* handle to the console output */
1657     int          x;             /* position where to start writing */
1658     int          y;
1659     int          mode;          /* char info (see below) */
1660     int          wrap;          /* wrap around at end of line? */
1661     VARARG(data,bytes);         /* info to write */
1662 @REPLY
1663     int          written;       /* number of char infos actually written */
1664     int          width;         /* width of screen buffer */
1665     int          height;        /* height of screen buffer */
1666 @END
1667 enum char_info_mode
1668 {
1669     CHAR_INFO_MODE_TEXT,        /* characters only */
1670     CHAR_INFO_MODE_ATTR,        /* attributes only */
1671     CHAR_INFO_MODE_TEXTATTR,    /* both characters and attributes */
1672     CHAR_INFO_MODE_TEXTSTDATTR  /* characters but use standard attributes */
1673 };
1674
1675
1676 /* fill a screen buffer with constant data (chars and/or attributes) */
1677 @REQ(fill_console_output)
1678     obj_handle_t handle;        /* handle to the console output */
1679     int          x;             /* position where to start writing */
1680     int          y;
1681     int          mode;          /* char info mode */
1682     int          count;         /* number to write */
1683     int          wrap;          /* wrap around at end of line? */
1684     char_info_t  data;          /* data to write */
1685 @REPLY
1686     int          written;       /* number of char infos actually written */
1687 @END
1688
1689
1690 /* read data (chars and/or attributes) from a screen buffer */
1691 @REQ(read_console_output)
1692     obj_handle_t handle;        /* handle to the console output */
1693     int          x;             /* position (x,y) where to start reading */
1694     int          y;
1695     int          mode;          /* char info mode */
1696     int          wrap;          /* wrap around at end of line? */
1697 @REPLY
1698     int          width;         /* width of screen buffer */
1699     int          height;        /* height of screen buffer */
1700     VARARG(data,bytes);
1701 @END
1702
1703
1704 /* move a rect (of data) in screen buffer content */
1705 @REQ(move_console_output)
1706     obj_handle_t handle;        /* handle to the console output */
1707     short int    x_src;         /* position (x, y) of rect to start moving from */
1708     short int    y_src;
1709     short int    x_dst;         /* position (x, y) of rect to move to */
1710     short int    y_dst;
1711     short int    w;             /* size of the rect (width, height) to move */
1712     short int    h;
1713 @END
1714
1715
1716 /* Sends a signal to a process group */
1717 @REQ(send_console_signal)
1718     int          signal;        /* the signal to send */
1719     process_id_t group_id;      /* the group to send the signal to */
1720 @END
1721
1722
1723 /* enable directory change notifications */
1724 @REQ(read_directory_changes)
1725     unsigned int filter;        /* notification filter */
1726     int          subtree;       /* watch the subtree? */
1727     int          want_data;     /* flag indicating whether change data should be collected */
1728     async_data_t async;         /* async I/O parameters */
1729 @END
1730
1731
1732 @REQ(read_change)
1733     obj_handle_t handle;
1734 @REPLY
1735     VARARG(events,filesystem_event);  /* collected filesystem events */
1736 @END
1737
1738
1739 /* Create a file mapping */
1740 @REQ(create_mapping)
1741     unsigned int access;        /* wanted access rights */
1742     unsigned int flags;         /* SEC_* flags */
1743     unsigned int file_access;   /* file access rights */
1744     mem_size_t   size;          /* mapping size */
1745     obj_handle_t file_handle;   /* file handle */
1746     VARARG(objattr,object_attributes); /* object attributes */
1747 @REPLY
1748     obj_handle_t handle;        /* handle to the mapping */
1749 @END
1750
1751
1752 /* Open a mapping */
1753 @REQ(open_mapping)
1754     unsigned int access;        /* wanted access rights */
1755     unsigned int attributes;    /* object attributes */
1756     obj_handle_t rootdir;       /* root directory */
1757     VARARG(name,unicode_str);   /* object name */
1758 @REPLY
1759     obj_handle_t handle;        /* handle to the mapping */
1760 @END
1761
1762
1763 /* Get information about a file mapping */
1764 @REQ(get_mapping_info)
1765     obj_handle_t handle;        /* handle to the mapping */
1766     unsigned int access;        /* wanted access rights */
1767 @REPLY
1768     mem_size_t   size;          /* mapping size */
1769     unsigned int flags;         /* SEC_* flags */
1770     obj_handle_t shared_file;   /* shared mapping file handle */
1771     VARARG(image,pe_image_info);/* image info for SEC_IMAGE mappings */
1772 @END
1773
1774
1775 /* Add a memory view in the current process */
1776 @REQ(map_view)
1777     obj_handle_t mapping;       /* file mapping handle */
1778     unsigned int access;        /* wanted access rights */
1779     client_ptr_t base;          /* view base address (page-aligned) */
1780     mem_size_t   size;          /* view size */
1781     file_pos_t   start;         /* start offset in mapping */
1782 @END
1783
1784
1785 /* Unmap a memory view from the current process */
1786 @REQ(unmap_view)
1787     client_ptr_t base;          /* view base address */
1788 @END
1789
1790
1791 /* Get a range of committed pages in a file mapping */
1792 @REQ(get_mapping_committed_range)
1793     client_ptr_t base;          /* view base address */
1794     file_pos_t   offset;        /* starting offset (page-aligned, in bytes) */
1795 @REPLY
1796     mem_size_t   size;          /* size of range starting at offset (page-aligned, in bytes) */
1797     int          committed;     /* whether it is a committed range */
1798 @END
1799
1800
1801 /* Add a range to the committed pages in a file mapping */
1802 @REQ(add_mapping_committed_range)
1803     client_ptr_t base;          /* view base address */
1804     file_pos_t   offset;        /* starting offset (page-aligned, in bytes) */
1805     mem_size_t   size;          /* size to set (page-aligned, in bytes) or 0 if only retrieving */
1806 @END
1807
1808
1809 /* Check if two memory maps are for the same file */
1810 @REQ(is_same_mapping)
1811     client_ptr_t base1;         /* first view base address */
1812     client_ptr_t base2;         /* second view base address */
1813 @END
1814
1815
1816 #define SNAP_PROCESS    0x00000001
1817 #define SNAP_THREAD     0x00000002
1818 /* Create a snapshot */
1819 @REQ(create_snapshot)
1820     unsigned int attributes;    /* object attributes */
1821     unsigned int flags;         /* snapshot flags (SNAP_*) */
1822 @REPLY
1823     obj_handle_t handle;        /* handle to the snapshot */
1824 @END
1825
1826
1827 /* Get the next process from a snapshot */
1828 @REQ(next_process)
1829     obj_handle_t handle;        /* handle to the snapshot */
1830     int          reset;         /* reset snapshot position? */
1831 @REPLY
1832     int          count;         /* process usage count */
1833     process_id_t pid;           /* process id */
1834     process_id_t ppid;          /* parent process id */
1835     int          threads;       /* number of threads */
1836     int          priority;      /* process priority */
1837     int          handles;       /* number of handles */
1838     int          unix_pid;      /* Unix pid */
1839     VARARG(filename,unicode_str); /* file name of main exe */
1840 @END
1841
1842
1843 /* Get the next thread from a snapshot */
1844 @REQ(next_thread)
1845     obj_handle_t handle;        /* handle to the snapshot */
1846     int          reset;         /* reset snapshot position? */
1847 @REPLY
1848     int          count;         /* thread usage count */
1849     process_id_t pid;           /* process id */
1850     thread_id_t  tid;           /* thread id */
1851     int          base_pri;      /* base priority */
1852     int          delta_pri;     /* delta priority */
1853 @END
1854
1855
1856 /* Wait for a debug event */
1857 @REQ(wait_debug_event)
1858     int           get_handle;  /* should we alloc a handle for waiting? */
1859 @REPLY
1860     process_id_t  pid;         /* process id */
1861     thread_id_t   tid;         /* thread id */
1862     obj_handle_t  wait;        /* wait handle if no event ready */
1863     VARARG(event,debug_event); /* debug event data */
1864 @END
1865
1866
1867 /* Queue an exception event */
1868 @REQ(queue_exception_event)
1869     int           first;       /* first chance exception? */
1870     unsigned int  code;        /* exception code */
1871     unsigned int  flags;       /* exception flags */
1872     client_ptr_t  record;      /* exception record */
1873     client_ptr_t  address;     /* exception address */
1874     data_size_t   len;         /* size of parameters */
1875     VARARG(params,uints64,len);/* exception parameters */
1876     VARARG(context,context);   /* thread context */
1877 @REPLY
1878     obj_handle_t     handle;   /* handle to the queued event */
1879 @END
1880
1881
1882 /* Retrieve the status of an exception event */
1883 @REQ(get_exception_status)
1884     obj_handle_t     handle;   /* handle to the queued event */
1885 @REPLY
1886     VARARG(context,context);   /* modified thread context */
1887 @END
1888
1889
1890 /* Continue a debug event */
1891 @REQ(continue_debug_event)
1892     process_id_t pid;          /* process id to continue */
1893     thread_id_t  tid;          /* thread id to continue */
1894     int          status;       /* continuation status */
1895 @END
1896
1897
1898 /* Start/stop debugging an existing process */
1899 @REQ(debug_process)
1900     process_id_t pid;          /* id of the process to debug */
1901     int          attach;       /* 1=attaching / 0=detaching from the process */
1902 @END
1903
1904
1905 /* Simulate a breakpoint in a process */
1906 @REQ(debug_break)
1907     obj_handle_t handle;       /* process handle */
1908 @REPLY
1909     int          self;         /* was it the caller itself? */
1910 @END
1911
1912
1913 /* Set debugger kill on exit flag */
1914 @REQ(set_debugger_kill_on_exit)
1915     int          kill_on_exit;  /* 0=detach/1=kill debuggee when debugger dies */
1916 @END
1917
1918
1919 /* Read data from a process address space */
1920 @REQ(read_process_memory)
1921     obj_handle_t handle;       /* process handle */
1922     client_ptr_t addr;         /* addr to read from */
1923 @REPLY
1924     VARARG(data,bytes);        /* result data */
1925 @END
1926
1927
1928 /* Write data to a process address space */
1929 @REQ(write_process_memory)
1930     obj_handle_t handle;       /* process handle */
1931     client_ptr_t addr;         /* addr to write to */
1932     VARARG(data,bytes);        /* data to write */
1933 @END
1934
1935
1936 /* Create a registry key */
1937 @REQ(create_key)
1938     unsigned int access;       /* desired access rights */
1939     unsigned int options;      /* creation options */
1940     VARARG(objattr,object_attributes); /* object attributes */
1941     VARARG(class,unicode_str);         /* class name */
1942 @REPLY
1943     obj_handle_t hkey;         /* handle to the created key */
1944     int          created;      /* has it been newly created? */
1945 @END
1946
1947 /* Open a registry key */
1948 @REQ(open_key)
1949     obj_handle_t parent;       /* handle to the parent key */
1950     unsigned int access;       /* desired access rights */
1951     unsigned int attributes;   /* object attributes */
1952     VARARG(name,unicode_str);  /* key name */
1953 @REPLY
1954     obj_handle_t hkey;         /* handle to the open key */
1955 @END
1956
1957
1958 /* Delete a registry key */
1959 @REQ(delete_key)
1960     obj_handle_t hkey;         /* handle to the key */
1961 @END
1962
1963
1964 /* Flush a registry key */
1965 @REQ(flush_key)
1966     obj_handle_t hkey;         /* handle to the key */
1967 @END
1968
1969
1970 /* Enumerate registry subkeys */
1971 @REQ(enum_key)
1972     obj_handle_t hkey;         /* handle to registry key */
1973     int          index;        /* index of subkey (or -1 for current key) */
1974     int          info_class;   /* requested information class */
1975 @REPLY
1976     int          subkeys;      /* number of subkeys */
1977     int          max_subkey;   /* longest subkey name */
1978     int          max_class;    /* longest class name */
1979     int          values;       /* number of values */
1980     int          max_value;    /* longest value name */
1981     int          max_data;     /* longest value data */
1982     timeout_t    modif;        /* last modification time */
1983     data_size_t  total;        /* total length needed for full name and class */
1984     data_size_t  namelen;      /* length of key name in bytes */
1985     VARARG(name,unicode_str,namelen);  /* key name */
1986     VARARG(class,unicode_str);         /* class name */
1987 @END
1988
1989
1990 /* Set a value of a registry key */
1991 @REQ(set_key_value)
1992     obj_handle_t hkey;         /* handle to registry key */
1993     int          type;         /* value type */
1994     data_size_t  namelen;      /* length of value name in bytes */
1995     VARARG(name,unicode_str,namelen);  /* value name */
1996     VARARG(data,bytes);                /* value data */
1997 @END
1998
1999
2000 /* Retrieve the value of a registry key */
2001 @REQ(get_key_value)
2002     obj_handle_t hkey;         /* handle to registry key */
2003     VARARG(name,unicode_str);  /* value name */
2004 @REPLY
2005     int          type;         /* value type */
2006     data_size_t  total;        /* total length needed for data */
2007     VARARG(data,bytes);        /* value data */
2008 @END
2009
2010
2011 /* Enumerate a value of a registry key */
2012 @REQ(enum_key_value)
2013     obj_handle_t hkey;         /* handle to registry key */
2014     int          index;        /* value index */
2015     int          info_class;   /* requested information class */
2016 @REPLY
2017     int          type;         /* value type */
2018     data_size_t  total;        /* total length needed for full name and data */
2019     data_size_t  namelen;      /* length of value name in bytes */
2020     VARARG(name,unicode_str,namelen);  /* value name */
2021     VARARG(data,bytes);                /* value data */
2022 @END
2023
2024
2025 /* Delete a value of a registry key */
2026 @REQ(delete_key_value)
2027     obj_handle_t hkey;         /* handle to registry key */
2028     VARARG(name,unicode_str);  /* value name */
2029 @END
2030
2031
2032 /* Load a registry branch from a file */
2033 @REQ(load_registry)
2034     obj_handle_t file;         /* file to load from */
2035     VARARG(objattr,object_attributes); /* object attributes */
2036 @END
2037
2038
2039 /* UnLoad a registry branch from a file */
2040 @REQ(unload_registry)
2041     obj_handle_t hkey;         /* root key to unload to */
2042 @END
2043
2044
2045 /* Save a registry branch to a file */
2046 @REQ(save_registry)
2047     obj_handle_t hkey;         /* key to save */
2048     obj_handle_t file;         /* file to save to */
2049 @END
2050
2051
2052 /* Add a registry key change notification */
2053 @REQ(set_registry_notification)
2054     obj_handle_t hkey;         /* key to watch for changes */
2055     obj_handle_t event;        /* event to set */
2056     int          subtree;      /* should we watch the whole subtree? */
2057     unsigned int filter;       /* things to watch */
2058 @END
2059
2060
2061 /* Create a waitable timer */
2062 @REQ(create_timer)
2063     unsigned int access;        /* wanted access rights */
2064     int          manual;        /* manual reset */
2065     VARARG(objattr,object_attributes); /* object attributes */
2066 @REPLY
2067     obj_handle_t handle;        /* handle to the timer */
2068 @END
2069
2070
2071 /* Open a waitable timer */
2072 @REQ(open_timer)
2073     unsigned int access;        /* wanted access rights */
2074     unsigned int attributes;    /* object attributes */
2075     obj_handle_t rootdir;       /* root directory */
2076     VARARG(name,unicode_str);   /* object name */
2077 @REPLY
2078     obj_handle_t handle;        /* handle to the timer */
2079 @END
2080
2081 /* Set a waitable timer */
2082 @REQ(set_timer)
2083     obj_handle_t handle;        /* handle to the timer */
2084     timeout_t    expire;        /* next expiration absolute time */
2085     client_ptr_t callback;      /* callback function */
2086     client_ptr_t arg;           /* callback argument */
2087     int          period;        /* timer period in ms */
2088 @REPLY
2089     int          signaled;      /* was the timer signaled before this call ? */
2090 @END
2091
2092 /* Cancel a waitable timer */
2093 @REQ(cancel_timer)
2094     obj_handle_t handle;        /* handle to the timer */
2095 @REPLY
2096      int         signaled;      /* was the timer signaled before this calltime ? */
2097 @END
2098
2099 /* Get information on a waitable timer */
2100 @REQ(get_timer_info)
2101     obj_handle_t handle;        /* handle to the timer */
2102 @REPLY
2103     timeout_t    when;          /* absolute time when the timer next expires */
2104     int          signaled;      /* is the timer signaled? */
2105 @END
2106
2107
2108 /* Retrieve the current context of a thread */
2109 @REQ(get_thread_context)
2110     obj_handle_t handle;       /* thread handle */
2111     unsigned int flags;        /* context flags */
2112     int          suspend;      /* suspend the thread if needed */
2113 @REPLY
2114     int          self;         /* was it a handle to the current thread? */
2115     VARARG(context,context);   /* thread context */
2116 @END
2117
2118
2119 /* Set the current context of a thread */
2120 @REQ(set_thread_context)
2121     obj_handle_t handle;       /* thread handle */
2122     int          suspend;      /* suspend the thread if needed */
2123     VARARG(context,context);   /* thread context */
2124 @REPLY
2125     int          self;         /* was it a handle to the current thread? */
2126 @END
2127
2128
2129 /* Fetch a selector entry for a thread */
2130 @REQ(get_selector_entry)
2131     obj_handle_t  handle;      /* thread handle */
2132     int           entry;       /* LDT entry */
2133 @REPLY
2134     unsigned int  base;        /* selector base */
2135     unsigned int  limit;       /* selector limit */
2136     unsigned char flags;       /* selector flags */
2137 @END
2138
2139
2140 /* Add an atom */
2141 @REQ(add_atom)
2142     obj_handle_t  table;       /* which table to add atom to */
2143     VARARG(name,unicode_str);  /* atom name */
2144 @REPLY
2145     atom_t        atom;        /* resulting atom */
2146 @END
2147
2148
2149 /* Delete an atom */
2150 @REQ(delete_atom)
2151     obj_handle_t  table;       /* which table to delete atom from */
2152     atom_t        atom;        /* atom handle */
2153 @END
2154
2155
2156 /* Find an atom */
2157 @REQ(find_atom)
2158     obj_handle_t table;        /* which table to find atom from */
2159     VARARG(name,unicode_str);  /* atom name */
2160 @REPLY
2161     atom_t       atom;         /* atom handle */
2162 @END
2163
2164
2165 /* Get information about an atom */
2166 @REQ(get_atom_information)
2167     obj_handle_t table;        /* which table to find atom from */
2168     atom_t       atom;         /* atom handle */
2169 @REPLY
2170     int          count;        /* atom lock count */
2171     int          pinned;       /* whether the atom has been pinned */
2172     data_size_t  total;        /* actual length of atom name */
2173     VARARG(name,unicode_str);  /* atom name */
2174 @END
2175
2176
2177 /* Set information about an atom */
2178 @REQ(set_atom_information)
2179     obj_handle_t table;        /* which table to find atom from */
2180     atom_t       atom;         /* atom handle */
2181     int          pinned;       /* whether to bump atom information */
2182 @END
2183
2184
2185 /* Empty an atom table */
2186 @REQ(empty_atom_table)
2187     obj_handle_t table;        /* which table to find atom from */
2188     int          if_pinned;    /* whether to delete pinned atoms */
2189 @END
2190
2191
2192 /* Init an atom table */
2193 @REQ(init_atom_table)
2194     int          entries;      /* number of entries (only for local) */
2195 @REPLY
2196     obj_handle_t table;        /* handle to the atom table */
2197 @END
2198
2199
2200 /* Get the message queue of the current thread */
2201 @REQ(get_msg_queue)
2202 @REPLY
2203     obj_handle_t handle;       /* handle to the queue */
2204 @END
2205
2206
2207 /* Set the file descriptor associated to the current thread queue */
2208 @REQ(set_queue_fd)
2209     obj_handle_t handle;       /* handle to the file descriptor */
2210 @END
2211
2212
2213 /* Set the current message queue wakeup mask */
2214 @REQ(set_queue_mask)
2215     unsigned int wake_mask;    /* wakeup bits mask */
2216     unsigned int changed_mask; /* changed bits mask */
2217     int          skip_wait;    /* will we skip waiting if signaled? */
2218 @REPLY
2219     unsigned int wake_bits;    /* current wake bits */
2220     unsigned int changed_bits; /* current changed bits */
2221 @END
2222
2223
2224 /* Get the current message queue status */
2225 @REQ(get_queue_status)
2226     unsigned int clear_bits;   /* should we clear the change bits? */
2227 @REPLY
2228     unsigned int wake_bits;    /* wake bits */
2229     unsigned int changed_bits; /* changed bits since last time */
2230 @END
2231
2232
2233 /* Retrieve the process idle event */
2234 @REQ(get_process_idle_event)
2235     obj_handle_t handle;       /* process handle */
2236 @REPLY
2237     obj_handle_t event;        /* handle to idle event */
2238 @END
2239
2240
2241 /* Send a message to a thread queue */
2242 @REQ(send_message)
2243     thread_id_t     id;        /* thread id */
2244     int             type;      /* message type (see below) */
2245     int             flags;     /* message flags (see below) */
2246     user_handle_t   win;       /* window handle */
2247     unsigned int    msg;       /* message code */
2248     lparam_t        wparam;    /* parameters */
2249     lparam_t        lparam;    /* parameters */
2250     timeout_t       timeout;   /* timeout for reply */
2251     VARARG(data,message_data); /* message data for sent messages */
2252 @END
2253
2254 @REQ(post_quit_message)
2255     int             exit_code; /* exit code to return */
2256 @END
2257
2258 enum message_type
2259 {
2260     MSG_ASCII,          /* Ascii message (from SendMessageA) */
2261     MSG_UNICODE,        /* Unicode message (from SendMessageW) */
2262     MSG_NOTIFY,         /* notify message (from SendNotifyMessageW), always Unicode */
2263     MSG_CALLBACK,       /* callback message (from SendMessageCallbackW), always Unicode */
2264     MSG_CALLBACK_RESULT,/* result of a callback message */
2265     MSG_OTHER_PROCESS,  /* sent from other process, may include vararg data, always Unicode */
2266     MSG_POSTED,         /* posted message (from PostMessageW), always Unicode */
2267     MSG_HARDWARE,       /* hardware message */
2268     MSG_WINEVENT,       /* winevent message */
2269     MSG_HOOK_LL         /* low-level hardware hook */
2270 };
2271 #define SEND_MSG_ABORT_IF_HUNG  0x01
2272
2273
2274 /* Send a hardware message to a thread queue */
2275 @REQ(send_hardware_message)
2276     user_handle_t   win;       /* window handle */
2277     hw_input_t      input;     /* input data */
2278     unsigned int    flags;     /* flags (see below) */
2279 @REPLY
2280     int             wait;      /* do we need to wait for a reply? */
2281     int             prev_x;    /* previous cursor position */
2282     int             prev_y;
2283     int             new_x;     /* new cursor position */
2284     int             new_y;
2285     VARARG(keystate,bytes);    /* global state array for all the keys */
2286 @END
2287 #define SEND_HWMSG_INJECTED    0x01
2288
2289
2290 /* Get a message from the current queue */
2291 @REQ(get_message)
2292     unsigned int    flags;     /* PM_* flags */
2293     user_handle_t   get_win;   /* window handle to get */
2294     unsigned int    get_first; /* first message code to get */
2295     unsigned int    get_last;  /* last message code to get */
2296     unsigned int    hw_id;     /* id of the previous hardware message (or 0) */
2297     unsigned int    wake_mask; /* wakeup bits mask */
2298     unsigned int    changed_mask; /* changed bits mask */
2299 @REPLY
2300     user_handle_t   win;       /* window handle */
2301     unsigned int    msg;       /* message code */
2302     lparam_t        wparam;    /* parameters */
2303     lparam_t        lparam;    /* parameters */
2304     int             type;      /* message type */
2305     int             x;         /* message x position */
2306     int             y;         /* message y position */
2307     unsigned int    time;      /* message time */
2308     unsigned int    active_hooks; /* active hooks bitmap */
2309     data_size_t     total;     /* total size of extra data */
2310     VARARG(data,message_data); /* message data for sent messages */
2311 @END
2312
2313
2314 /* Reply to a sent message */
2315 @REQ(reply_message)
2316     int             remove;    /* should we remove the message? */
2317     lparam_t        result;    /* message result */
2318     VARARG(data,bytes);        /* message data for sent messages */
2319 @END
2320
2321
2322 /* Accept the current hardware message */
2323 @REQ(accept_hardware_message)
2324     unsigned int    hw_id;     /* id of the hardware message */
2325     int             remove;    /* should we remove the message? */
2326 @END
2327
2328
2329 /* Retrieve the reply for the last message sent */
2330 @REQ(get_message_reply)
2331     int             cancel;    /* cancel message if not ready? */
2332 @REPLY
2333     lparam_t        result;    /* message result */
2334     VARARG(data,bytes);        /* message data for sent messages */
2335 @END
2336
2337
2338 /* Set a window timer */
2339 @REQ(set_win_timer)
2340     user_handle_t   win;       /* window handle */
2341     unsigned int    msg;       /* message to post */
2342     unsigned int    rate;      /* timer rate in ms */
2343     lparam_t        id;        /* timer id */
2344     lparam_t        lparam;    /* message lparam (callback proc) */
2345 @REPLY
2346     lparam_t        id;        /* timer id */
2347 @END
2348
2349
2350 /* Kill a window timer */
2351 @REQ(kill_win_timer)
2352     user_handle_t   win;       /* window handle */
2353     lparam_t        id;        /* timer id */
2354     unsigned int    msg;       /* message to post */
2355 @END
2356
2357
2358 /* check if the thread owning the window is hung */
2359 @REQ(is_window_hung)
2360     user_handle_t   win;       /* window handle */
2361 @REPLY
2362     int is_hung;
2363 @END
2364
2365
2366 /* Retrieve info about a serial port */
2367 @REQ(get_serial_info)
2368     obj_handle_t handle;       /* handle to comm port */
2369     int          flags;
2370 @REPLY
2371     unsigned int eventmask;
2372     unsigned int cookie;
2373     unsigned int pending_write;
2374 @END
2375
2376
2377 /* Set info about a serial port */
2378 @REQ(set_serial_info)
2379     obj_handle_t handle;       /* handle to comm port */
2380     int          flags;        /* bitmask to set values (see below) */
2381 @END
2382 #define SERIALINFO_PENDING_WRITE 0x04
2383 #define SERIALINFO_PENDING_WAIT  0x08
2384
2385
2386 /* Create an async I/O */
2387 @REQ(register_async)
2388     int          type;          /* type of queue to look after */
2389     async_data_t async;         /* async I/O parameters */
2390     int          count;         /* count - usually # of bytes to be read/written */
2391 @END
2392 #define ASYNC_TYPE_READ  0x01
2393 #define ASYNC_TYPE_WRITE 0x02
2394 #define ASYNC_TYPE_WAIT  0x03
2395
2396
2397 /* Cancel all async op on a fd */
2398 @REQ(cancel_async)
2399     obj_handle_t handle;        /* handle to comm port, socket or file */
2400     client_ptr_t iosb;          /* I/O status block (NULL=all) */
2401     int          only_thread;   /* cancel matching this thread */
2402 @END
2403
2404
2405 /* Retrieve results of an async */
2406 @REQ(get_async_result)
2407     client_ptr_t   user_arg;      /* user arg used to identify async */
2408 @REPLY
2409     data_size_t    size;          /* result size (input or output depending on the operation) */
2410     VARARG(out_data,bytes);       /* iosb output data */
2411 @END
2412
2413
2414 /* Perform a read on a file object */
2415 @REQ(read)
2416     async_data_t   async;         /* async I/O parameters */
2417     file_pos_t     pos;           /* read position */
2418 @REPLY
2419     obj_handle_t   wait;          /* handle to wait on for blocking read */
2420     unsigned int   options;       /* device open options */
2421     VARARG(data,bytes);           /* read data */
2422 @END
2423
2424
2425 /* Perform a write on a file object */
2426 @REQ(write)
2427     async_data_t   async;         /* async I/O parameters */
2428     file_pos_t     pos;           /* write position */
2429     VARARG(data,bytes);           /* write data */
2430 @REPLY
2431     obj_handle_t   wait;          /* handle to wait on for blocking write */
2432     unsigned int   options;       /* device open options */
2433     data_size_t    size;          /* size written */
2434 @END
2435
2436
2437 /* Perform an ioctl on a file */
2438 @REQ(ioctl)
2439     ioctl_code_t   code;          /* ioctl code */
2440     async_data_t   async;         /* async I/O parameters */
2441     VARARG(in_data,bytes);        /* ioctl input data */
2442 @REPLY
2443     obj_handle_t   wait;          /* handle to wait on for blocking ioctl */
2444     unsigned int   options;       /* device open options */
2445     VARARG(out_data,bytes);       /* ioctl output data */
2446 @END
2447
2448
2449 /* Store results of an async irp */
2450 @REQ(set_irp_result)
2451     obj_handle_t handle;          /* handle to the irp */
2452     unsigned int status;          /* status of the irp */
2453     data_size_t  size;            /* result size (input or output depending on the operation) */
2454     client_ptr_t file_ptr;        /* opaque pointer to the file object */
2455     VARARG(data,bytes);           /* output data of the irp */
2456 @END
2457
2458
2459 /* Create a named pipe */
2460 @REQ(create_named_pipe)
2461     unsigned int   access;
2462     unsigned int   options;
2463     unsigned int   sharing;
2464     unsigned int   maxinstances;
2465     unsigned int   outsize;
2466     unsigned int   insize;
2467     timeout_t      timeout;
2468     unsigned int   flags;
2469     VARARG(objattr,object_attributes); /* object attributes */
2470 @REPLY
2471     obj_handle_t   handle;       /* handle to the pipe */
2472 @END
2473
2474 /* flags in create_named_pipe and get_named_pipe_info */
2475 #define NAMED_PIPE_MESSAGE_STREAM_WRITE 0x0001
2476 #define NAMED_PIPE_MESSAGE_STREAM_READ  0x0002
2477 #define NAMED_PIPE_NONBLOCKING_MODE     0x0004
2478 #define NAMED_PIPE_SERVER_END           0x8000
2479
2480 /* Set named pipe information by handle */
2481 @REQ(set_named_pipe_info)
2482     obj_handle_t   handle;
2483     unsigned int   flags;
2484 @END
2485
2486 /* Create a window */
2487 @REQ(create_window)
2488     user_handle_t  parent;      /* parent window */
2489     user_handle_t  owner;       /* owner window */
2490     atom_t         atom;        /* class atom */
2491     mod_handle_t   instance;    /* module instance */
2492     int            dpi;         /* system DPI */
2493     int            awareness;   /* thread DPI awareness */
2494     VARARG(class,unicode_str);  /* class name */
2495 @REPLY
2496     user_handle_t  handle;      /* created window */
2497     user_handle_t  parent;      /* full handle of parent */
2498     user_handle_t  owner;       /* full handle of owner */
2499     int            extra;       /* number of extra bytes */
2500     client_ptr_t   class_ptr;   /* pointer to class in client address space */
2501     int            dpi;         /* window DPI if not per-monitor aware */
2502     int            awareness;   /* window DPI awareness */
2503 @END
2504
2505
2506 /* Destroy a window */
2507 @REQ(destroy_window)
2508     user_handle_t  handle;      /* handle to the window */
2509 @END
2510
2511
2512 /* Retrieve the desktop window for the current thread */
2513 @REQ(get_desktop_window)
2514     int            force;       /* force creation if it doesn't exist */
2515 @REPLY
2516     user_handle_t  top_window;  /* handle to the desktop window */
2517     user_handle_t  msg_window;  /* handle to the top-level HWND_MESSAGE parent */
2518 @END
2519
2520
2521 /* Set a window owner */
2522 @REQ(set_window_owner)
2523     user_handle_t  handle;      /* handle to the window */
2524     user_handle_t  owner;       /* new owner */
2525 @REPLY
2526     user_handle_t  full_owner;  /* full handle of new owner */
2527     user_handle_t  prev_owner;  /* full handle of previous owner */
2528 @END
2529
2530
2531 /* Get information from a window handle */
2532 @REQ(get_window_info)
2533     user_handle_t  handle;      /* handle to the window */
2534 @REPLY
2535     user_handle_t  full_handle; /* full 32-bit handle */
2536     user_handle_t  last_active; /* last active popup */
2537     process_id_t   pid;         /* process owning the window */
2538     thread_id_t    tid;         /* thread owning the window */
2539     atom_t         atom;        /* class atom */
2540     int            is_unicode;  /* ANSI or unicode */
2541     int            dpi;         /* window DPI */
2542     int            awareness;   /* DPI awareness */
2543 @END
2544
2545
2546 /* Set some information in a window */
2547 @REQ(set_window_info)
2548     unsigned short flags;         /* flags for fields to set (see below) */
2549     short int      is_unicode;    /* ANSI or unicode */
2550     user_handle_t  handle;        /* handle to the window */
2551     unsigned int   style;         /* window style */
2552     unsigned int   ex_style;      /* window extended style */
2553     unsigned int   id;            /* window id */
2554     mod_handle_t   instance;      /* creator instance */
2555     lparam_t       user_data;     /* user-specific data */
2556     int            extra_offset;  /* offset to set in extra bytes */
2557     data_size_t    extra_size;    /* size to set in extra bytes */
2558     lparam_t       extra_value;   /* value to set in extra bytes */
2559 @REPLY
2560     unsigned int   old_style;     /* old window style */
2561     unsigned int   old_ex_style;  /* old window extended style */
2562     mod_handle_t   old_instance;  /* old creator instance */
2563     lparam_t       old_user_data; /* old user-specific data */
2564     lparam_t       old_extra_value; /* old value in extra bytes */
2565     unsigned int   old_id;        /* old window id */
2566 @END
2567 #define SET_WIN_STYLE     0x01
2568 #define SET_WIN_EXSTYLE   0x02
2569 #define SET_WIN_ID        0x04
2570 #define SET_WIN_INSTANCE  0x08
2571 #define SET_WIN_USERDATA  0x10
2572 #define SET_WIN_EXTRA     0x20
2573 #define SET_WIN_UNICODE   0x40
2574
2575
2576 /* Set the parent of a window */
2577 @REQ(set_parent)
2578     user_handle_t  handle;      /* handle to the window */
2579     user_handle_t  parent;      /* handle to the parent */
2580 @REPLY
2581     user_handle_t  old_parent;  /* old parent window */
2582     user_handle_t  full_parent; /* full handle of new parent */
2583     int            dpi;         /* new window DPI if not per-monitor aware */
2584     int            awareness;   /* new DPI awareness */
2585 @END
2586
2587
2588 /* Get a list of the window parents, up to the root of the tree */
2589 @REQ(get_window_parents)
2590     user_handle_t  handle;        /* handle to the window */
2591 @REPLY
2592     int            count;         /* total count of parents */
2593     VARARG(parents,user_handles); /* parent handles */
2594 @END
2595
2596
2597 /* Get a list of the window children */
2598 @REQ(get_window_children)
2599     obj_handle_t   desktop;       /* handle to desktop */
2600     user_handle_t  parent;        /* parent window */
2601     atom_t         atom;          /* class atom for the listed children */
2602     thread_id_t    tid;           /* thread owning the listed children */
2603     VARARG(class,unicode_str);    /* class name */
2604 @REPLY
2605     int            count;         /* total count of children */
2606     VARARG(children,user_handles); /* children handles */
2607 @END
2608
2609
2610 /* Get a list of the window children that contain a given point */
2611 @REQ(get_window_children_from_point)
2612     user_handle_t  parent;        /* parent window */
2613     int            x;             /* point in parent coordinates */
2614     int            y;
2615     int            dpi;           /* dpi for the point coordinates */
2616 @REPLY
2617     int            count;         /* total count of children */
2618     VARARG(children,user_handles); /* children handles */
2619 @END
2620
2621
2622 /* Get window tree information from a window handle */
2623 @REQ(get_window_tree)
2624     user_handle_t  handle;        /* handle to the window */
2625 @REPLY
2626     user_handle_t  parent;        /* parent window */
2627     user_handle_t  owner;         /* owner window */
2628     user_handle_t  next_sibling;  /* next sibling in Z-order */
2629     user_handle_t  prev_sibling;  /* prev sibling in Z-order */
2630     user_handle_t  first_sibling; /* first sibling in Z-order */
2631     user_handle_t  last_sibling;  /* last sibling in Z-order */
2632     user_handle_t  first_child;   /* first child */
2633     user_handle_t  last_child;    /* last child */
2634 @END
2635
2636 /* Set the position and Z order of a window */
2637 @REQ(set_window_pos)
2638     unsigned short swp_flags;     /* SWP_* flags */
2639     unsigned short paint_flags;   /* paint flags (see below) */
2640     user_handle_t  handle;        /* handle to the window */
2641     user_handle_t  previous;      /* previous window in Z order */
2642     rectangle_t    window;        /* window rectangle (in parent coords) */
2643     rectangle_t    client;        /* client rectangle (in parent coords) */
2644     VARARG(valid,rectangles);     /* valid rectangles from WM_NCCALCSIZE (in parent coords) */
2645 @REPLY
2646     unsigned int   new_style;     /* new window style */
2647     unsigned int   new_ex_style;  /* new window extended style */
2648     user_handle_t  surface_win;   /* parent window that holds the surface */
2649     int            needs_update;  /* whether the surface region needs an update */
2650 @END
2651 #define SET_WINPOS_PAINT_SURFACE 0x01  /* window has a paintable surface */
2652 #define SET_WINPOS_PIXEL_FORMAT  0x02  /* window has a custom pixel format */
2653
2654 /* Get the window and client rectangles of a window */
2655 @REQ(get_window_rectangles)
2656     user_handle_t  handle;        /* handle to the window */
2657     int            relative;      /* coords relative to (see below) */
2658     int            dpi;           /* DPI to map to, or zero for per-monitor DPI */
2659 @REPLY
2660     rectangle_t    window;        /* window rectangle */
2661     rectangle_t    client;        /* client rectangle */
2662 @END
2663 enum coords_relative
2664 {
2665     COORDS_CLIENT,   /* relative to client area */
2666     COORDS_WINDOW,   /* relative to whole window area */
2667     COORDS_PARENT,   /* relative to parent's client area */
2668     COORDS_SCREEN    /* relative to screen origin */
2669 };
2670
2671
2672 /* Get the window text */
2673 @REQ(get_window_text)
2674     user_handle_t  handle;        /* handle to the window */
2675 @REPLY
2676     data_size_t    length;        /* total length in WCHARs */
2677     VARARG(text,unicode_str);     /* window text */
2678 @END
2679
2680
2681 /* Set the window text */
2682 @REQ(set_window_text)
2683     user_handle_t  handle;        /* handle to the window */
2684     VARARG(text,unicode_str);     /* window text */
2685 @END
2686
2687
2688 /* Get the coordinates offset between two windows */
2689 @REQ(get_windows_offset)
2690     user_handle_t  from;          /* handle to the first window */
2691     user_handle_t  to;            /* handle to the second window */
2692     int            dpi;           /* DPI to map to, or zero for per-monitor DPI */
2693 @REPLY
2694     int            x;             /* x coordinate offset */
2695     int            y;             /* y coordinate offset */
2696     int            mirror;        /* whether to mirror the x coordinate */
2697 @END
2698
2699
2700 /* Get the visible region of a window */
2701 @REQ(get_visible_region)
2702     user_handle_t  window;        /* handle to the window */
2703     unsigned int   flags;         /* DCX flags */
2704 @REPLY
2705     user_handle_t  top_win;       /* top window to clip against */
2706     rectangle_t    top_rect;      /* top window visible rect with screen coords */
2707     rectangle_t    win_rect;      /* window rect in screen coords */
2708     unsigned int   paint_flags;   /* paint flags (from SET_WINPOS_* flags) */
2709     data_size_t    total_size;    /* total size of the resulting region */
2710     VARARG(region,rectangles);    /* list of rectangles for the region (in screen coords) */
2711 @END
2712
2713
2714 /* Get the visible surface region of a window */
2715 @REQ(get_surface_region)
2716     user_handle_t  window;        /* handle to the window */
2717 @REPLY
2718     rectangle_t    visible_rect;  /* window visible rect in screen coords */
2719     data_size_t    total_size;    /* total size of the resulting region */
2720     VARARG(region,rectangles);    /* list of rectangles for the region (in screen coords) */
2721 @END
2722
2723
2724 /* Get the window region */
2725 @REQ(get_window_region)
2726     user_handle_t  window;        /* handle to the window */
2727 @REPLY
2728     data_size_t    total_size;    /* total size of the resulting region */
2729     VARARG(region,rectangles);    /* list of rectangles for the region (in window coords) */
2730 @END
2731
2732
2733 /* Set the window region */
2734 @REQ(set_window_region)
2735     user_handle_t  window;        /* handle to the window */
2736     int            redraw;        /* redraw the window? */
2737     VARARG(region,rectangles);    /* list of rectangles for the region (in window coords) */
2738 @END
2739
2740
2741 /* Get the window update region */
2742 @REQ(get_update_region)
2743     user_handle_t  window;        /* handle to the window */
2744     user_handle_t  from_child;    /* child to start searching from */
2745     unsigned int   flags;         /* update flags (see below) */
2746 @REPLY
2747     user_handle_t  child;         /* child to repaint (or window itself) */
2748     unsigned int   flags;         /* resulting update flags (see below) */
2749     data_size_t    total_size;    /* total size of the resulting region */
2750     VARARG(region,rectangles);    /* list of rectangles for the region (in screen coords) */
2751 @END
2752 #define UPDATE_NONCLIENT       0x001  /* get region for repainting non-client area */
2753 #define UPDATE_ERASE           0x002  /* get region for erasing client area */
2754 #define UPDATE_PAINT           0x004  /* get region for painting client area */
2755 #define UPDATE_INTERNALPAINT   0x008  /* get region if internal paint is pending */
2756 #define UPDATE_ALLCHILDREN     0x010  /* force repaint of all children */
2757 #define UPDATE_NOCHILDREN      0x020  /* don't try to repaint any children */
2758 #define UPDATE_NOREGION        0x040  /* don't return a region, only the flags */
2759 #define UPDATE_DELAYED_ERASE   0x080  /* still needs erase after BeginPaint */
2760 #define UPDATE_CLIPCHILDREN    0x100  /* remove clipped children from the update region */
2761
2762
2763 /* Update the z order of a window so that a given rectangle is fully visible */
2764 @REQ(update_window_zorder)
2765     user_handle_t  window;        /* handle to the window */
2766     rectangle_t    rect;          /* rectangle that must be visible (in client coords) */
2767 @END
2768
2769
2770 /* Mark parts of a window as needing a redraw */
2771 @REQ(redraw_window)
2772     user_handle_t  window;        /* handle to the window */
2773     unsigned int   flags;         /* RDW_* flags */
2774     VARARG(region,rectangles);    /* list of rectangles for the region (in window coords) */
2775 @END
2776
2777
2778 /* Set a window property */
2779 @REQ(set_window_property)
2780     user_handle_t  window;        /* handle to the window */
2781     lparam_t       data;          /* data to store */
2782     atom_t         atom;          /* property atom (if no name specified) */
2783     VARARG(name,unicode_str);     /* property name */
2784 @END
2785
2786
2787 /* Remove a window property */
2788 @REQ(remove_window_property)
2789     user_handle_t  window;        /* handle to the window */
2790     atom_t         atom;          /* property atom (if no name specified) */
2791     VARARG(name,unicode_str);     /* property name */
2792 @REPLY
2793     lparam_t       data;          /* data stored in property */
2794 @END
2795
2796
2797 /* Get a window property */
2798 @REQ(get_window_property)
2799     user_handle_t  window;        /* handle to the window */
2800     atom_t         atom;          /* property atom (if no name specified) */
2801     VARARG(name,unicode_str);     /* property name */
2802 @REPLY
2803     lparam_t       data;          /* data stored in property */
2804 @END
2805
2806
2807 /* Get the list of properties of a window */
2808 @REQ(get_window_properties)
2809     user_handle_t  window;        /* handle to the window */
2810 @REPLY
2811     int            total;         /* total number of properties */
2812     VARARG(props,properties);     /* list of properties */
2813 @END
2814
2815
2816 /* Create a window station */
2817 @REQ(create_winstation)
2818     unsigned int flags;           /* window station flags */
2819     unsigned int access;          /* wanted access rights */
2820     unsigned int attributes;      /* object attributes */
2821     obj_handle_t rootdir;         /* root directory */
2822     VARARG(name,unicode_str);     /* object name */
2823 @REPLY
2824     obj_handle_t handle;          /* handle to the window station */
2825 @END
2826
2827
2828 /* Open a handle to a window station */
2829 @REQ(open_winstation)
2830     unsigned int access;          /* wanted access rights */
2831     unsigned int attributes;      /* object attributes */
2832     obj_handle_t rootdir;         /* root directory */
2833     VARARG(name,unicode_str);     /* object name */
2834 @REPLY
2835     obj_handle_t handle;          /* handle to the window station */
2836 @END
2837
2838
2839 /* Close a window station */
2840 @REQ(close_winstation)
2841     obj_handle_t handle;          /* handle to the window station */
2842 @END
2843
2844
2845 /* Get the process current window station */
2846 @REQ(get_process_winstation)
2847 @REPLY
2848     obj_handle_t handle;          /* handle to the window station */
2849 @END
2850
2851
2852 /* Set the process current window station */
2853 @REQ(set_process_winstation)
2854     obj_handle_t handle;          /* handle to the window station */
2855 @END
2856
2857
2858 /* Enumerate window stations */
2859 @REQ(enum_winstation)
2860     unsigned int index;           /* current index */
2861 @REPLY
2862     unsigned int next;            /* next index */
2863     VARARG(name,unicode_str);     /* window station name */
2864 @END
2865
2866
2867 /* Create a desktop */
2868 @REQ(create_desktop)
2869     unsigned int flags;           /* desktop flags */
2870     unsigned int access;          /* wanted access rights */
2871     unsigned int attributes;      /* object attributes */
2872     VARARG(name,unicode_str);     /* object name */
2873 @REPLY
2874     obj_handle_t handle;          /* handle to the desktop */
2875 @END
2876
2877
2878 /* Open a handle to a desktop */
2879 @REQ(open_desktop)
2880     obj_handle_t winsta;          /* window station to open (null allowed) */
2881     unsigned int flags;           /* desktop flags */
2882     unsigned int access;          /* wanted access rights */
2883     unsigned int attributes;      /* object attributes */
2884     VARARG(name,unicode_str);     /* object name */
2885 @REPLY
2886     obj_handle_t handle;          /* handle to the desktop */
2887 @END
2888
2889
2890 /* Open a handle to current input desktop */
2891 @REQ(open_input_desktop)
2892     unsigned int flags;           /* desktop flags */
2893     unsigned int access;          /* wanted access rights */
2894     unsigned int attributes;      /* object attributes */
2895 @REPLY
2896     obj_handle_t handle;          /* handle to the desktop */
2897 @END
2898
2899
2900 /* Close a desktop */
2901 @REQ(close_desktop)
2902     obj_handle_t handle;          /* handle to the desktop */
2903 @END
2904
2905
2906 /* Get the thread current desktop */
2907 @REQ(get_thread_desktop)
2908     thread_id_t  tid;             /* thread id */
2909 @REPLY
2910     obj_handle_t handle;          /* handle to the desktop */
2911 @END
2912
2913
2914 /* Set the thread current desktop */
2915 @REQ(set_thread_desktop)
2916     obj_handle_t handle;          /* handle to the desktop */
2917 @END
2918
2919
2920 /* Enumerate desktops */
2921 @REQ(enum_desktop)
2922     obj_handle_t winstation;      /* handle to the window station */
2923     unsigned int index;           /* current index */
2924 @REPLY
2925     unsigned int next;            /* next index */
2926     VARARG(name,unicode_str);     /* window station name */
2927 @END
2928
2929
2930 /* Get/set information about a user object (window station or desktop) */
2931 @REQ(set_user_object_info)
2932     obj_handle_t handle;          /* handle to the object */
2933     unsigned int flags;           /* information to set/get */
2934     unsigned int obj_flags;       /* new object flags */
2935 @REPLY
2936     int          is_desktop;      /* is object a desktop? */
2937     unsigned int old_obj_flags;   /* old object flags */
2938     VARARG(name,unicode_str);     /* object name */
2939 @END
2940 #define SET_USER_OBJECT_SET_FLAGS       1
2941 #define SET_USER_OBJECT_GET_FULL_NAME   2
2942
2943
2944 /* Register a hotkey */
2945 @REQ(register_hotkey)
2946     user_handle_t  window;        /* handle to the window */
2947     int            id;            /* hotkey identifier */
2948     unsigned int   flags;         /* modifier keys */
2949     unsigned int   vkey;          /* virtual key code */
2950 @REPLY
2951     int            replaced;      /* did we replace an existing hotkey? */
2952     unsigned int   flags;         /* flags of replaced hotkey */
2953     unsigned int   vkey;          /* virtual key code of replaced hotkey */
2954 @END
2955
2956
2957 /* Unregister a hotkey */
2958 @REQ(unregister_hotkey)
2959     user_handle_t  window;        /* handle to the window */
2960     int            id;            /* hotkey identifier */
2961 @REPLY
2962     unsigned int   flags;         /* flags of removed hotkey */
2963     unsigned int   vkey;          /* virtual key code of removed hotkey */
2964 @END
2965
2966
2967 /* Attach (or detach) thread inputs */
2968 @REQ(attach_thread_input)
2969     thread_id_t    tid_from;       /* thread to be attached */
2970     thread_id_t    tid_to;         /* thread to which tid_from should be attached */
2971     int            attach;         /* is it an attach? */
2972 @END
2973
2974
2975 /* Get input data for a given thread */
2976 @REQ(get_thread_input)
2977     thread_id_t    tid;           /* id of thread */
2978 @REPLY
2979     user_handle_t  focus;         /* handle to the focus window */
2980     user_handle_t  capture;       /* handle to the capture window */
2981     user_handle_t  active;        /* handle to the active window */
2982     user_handle_t  foreground;    /* handle to the global foreground window */
2983     user_handle_t  menu_owner;    /* handle to the menu owner */
2984     user_handle_t  move_size;     /* handle to the moving/resizing window */
2985     user_handle_t  caret;         /* handle to the caret window */
2986     user_handle_t  cursor;        /* handle to the cursor */
2987     int            show_count;    /* cursor show count */
2988     rectangle_t    rect;          /* caret rectangle */
2989 @END
2990
2991
2992 /* Get the time of the last input event */
2993 @REQ(get_last_input_time)
2994 @REPLY
2995     unsigned int time;
2996 @END
2997
2998
2999 /* Retrieve queue keyboard state for a given thread */
3000 @REQ(get_key_state)
3001     thread_id_t    tid;           /* id of thread */
3002     int            key;           /* optional key code or -1 */
3003 @REPLY
3004     unsigned char  state;         /* state of specified key */
3005     VARARG(keystate,bytes);       /* state array for all the keys */
3006 @END
3007
3008 /* Set queue keyboard state for a given thread */
3009 @REQ(set_key_state)
3010     thread_id_t    tid;           /* id of thread */
3011     int            async;         /* whether to change the async state too */
3012     VARARG(keystate,bytes);       /* state array for all the keys */
3013 @END
3014
3015 /* Set the system foreground window */
3016 @REQ(set_foreground_window)
3017     user_handle_t  handle;        /* handle to the foreground window */
3018 @REPLY
3019     user_handle_t  previous;      /* handle to the previous foreground window */
3020     int            send_msg_old;  /* whether we have to send a msg to the old window */
3021     int            send_msg_new;  /* whether we have to send a msg to the new window */
3022 @END
3023
3024 /* Set the current thread focus window */
3025 @REQ(set_focus_window)
3026     user_handle_t  handle;        /* handle to the focus window */
3027 @REPLY
3028     user_handle_t  previous;      /* handle to the previous focus window */
3029 @END
3030
3031 /* Set the current thread active window */
3032 @REQ(set_active_window)
3033     user_handle_t  handle;        /* handle to the active window */
3034 @REPLY
3035     user_handle_t  previous;      /* handle to the previous active window */
3036 @END
3037
3038 /* Set the current thread capture window */
3039 @REQ(set_capture_window)
3040     user_handle_t  handle;        /* handle to the capture window */
3041     unsigned int   flags;         /* capture flags (see below) */
3042 @REPLY
3043     user_handle_t  previous;      /* handle to the previous capture window */
3044     user_handle_t  full_handle;   /* full 32-bit handle of new capture window */
3045 @END
3046 #define CAPTURE_MENU     0x01  /* capture is for a menu */
3047 #define CAPTURE_MOVESIZE 0x02  /* capture is for moving/resizing */
3048
3049
3050 /* Set the current thread caret window */
3051 @REQ(set_caret_window)
3052     user_handle_t  handle;        /* handle to the caret window */
3053     int            width;         /* caret width */
3054     int            height;        /* caret height */
3055 @REPLY
3056     user_handle_t  previous;      /* handle to the previous caret window */
3057     rectangle_t    old_rect;      /* previous caret rectangle */
3058     int            old_hide;      /* previous hide count */
3059     int            old_state;     /* previous caret state (1=on, 0=off) */
3060 @END
3061
3062
3063 /* Set the current thread caret information */
3064 @REQ(set_caret_info)
3065     unsigned int   flags;         /* caret flags (see below) */
3066     user_handle_t  handle;        /* handle to the caret window */
3067     int            x;             /* caret x position */
3068     int            y;             /* caret y position */
3069     int            hide;          /* increment for hide count (can be negative to show it) */
3070     int            state;         /* caret state (see below) */
3071 @REPLY
3072     user_handle_t  full_handle;   /* handle to the current caret window */
3073     rectangle_t    old_rect;      /* previous caret rectangle */
3074     int            old_hide;      /* previous hide count */
3075     int            old_state;     /* previous caret state (1=on, 0=off) */
3076 @END
3077 #define SET_CARET_POS        0x01  /* set the caret position from x,y */
3078 #define SET_CARET_HIDE       0x02  /* increment the caret hide count */
3079 #define SET_CARET_STATE      0x04  /* set the caret on/off state */
3080 enum caret_state
3081 {
3082     CARET_STATE_OFF,        /* off */
3083     CARET_STATE_ON,         /* on */
3084     CARET_STATE_TOGGLE,     /* toggle current state */
3085     CARET_STATE_ON_IF_MOVED /* on if the position differs, unchanged otherwise */
3086 };
3087
3088
3089 /* Set a window hook */
3090 @REQ(set_hook)
3091     int            id;             /* id of the hook */
3092     process_id_t   pid;            /* id of process to set the hook into */
3093     thread_id_t    tid;            /* id of thread to set the hook into */
3094     int            event_min;
3095     int            event_max;
3096     client_ptr_t   proc;           /* hook procedure */
3097     int            flags;
3098     int            unicode;        /* is it a unicode hook? */
3099     VARARG(module,unicode_str);    /* module name */
3100 @REPLY
3101     user_handle_t  handle;         /* handle to the hook */
3102     unsigned int   active_hooks;   /* active hooks bitmap */
3103 @END
3104
3105
3106 /* Remove a window hook */
3107 @REQ(remove_hook)
3108     user_handle_t  handle;         /* handle to the hook */
3109     client_ptr_t   proc;           /* hook procedure if handle is 0 */
3110     int            id;             /* id of the hook if handle is 0 */
3111 @REPLY
3112     unsigned int   active_hooks;   /* active hooks bitmap */
3113 @END
3114
3115
3116 /* Start calling a hook chain */
3117 @REQ(start_hook_chain)
3118     int            id;             /* id of the hook */
3119     int            event;          /* signalled event */
3120     user_handle_t  window;         /* handle to the event window */
3121     int            object_id;      /* object id for out of context winevent */
3122     int            child_id;       /* child id for out of context winevent */
3123 @REPLY
3124     user_handle_t  handle;         /* handle to the next hook */
3125     process_id_t   pid;            /* process id for low-level keyboard/mouse hooks */
3126     thread_id_t    tid;            /* thread id for low-level keyboard/mouse hooks */
3127     int            unicode;        /* is it a unicode hook? */
3128     client_ptr_t   proc;           /* hook procedure */
3129     unsigned int   active_hooks;   /* active hooks bitmap */
3130     VARARG(module,unicode_str);    /* module name */
3131 @END
3132
3133
3134 /* Finished calling a hook chain */
3135 @REQ(finish_hook_chain)
3136     int            id;             /* id of the hook */
3137 @END
3138
3139
3140 /* Get the hook information */
3141 @REQ(get_hook_info)
3142     user_handle_t  handle;         /* handle to the current hook */
3143     int            get_next;       /* do we want info about current or next hook? */
3144     int            event;          /* signalled event */
3145     user_handle_t  window;         /* handle to the event window */
3146     int            object_id;      /* object id for out of context winevent */
3147     int            child_id;       /* child id for out of context winevent */
3148 @REPLY
3149     user_handle_t  handle;         /* handle to the hook */
3150     int            id;             /* id of the hook */
3151     process_id_t   pid;            /* process id for low-level keyboard/mouse hooks */
3152     thread_id_t    tid;            /* thread id for low-level keyboard/mouse hooks */
3153     client_ptr_t   proc;           /* hook procedure */
3154     int            unicode;        /* is it a unicode hook? */
3155     VARARG(module,unicode_str);    /* module name */
3156 @END
3157
3158
3159 /* Create a window class */
3160 @REQ(create_class)
3161     int            local;          /* is it a local class? */
3162     atom_t         atom;           /* class atom */
3163     unsigned int   style;          /* class style */
3164     mod_handle_t   instance;       /* module instance */
3165     int            extra;          /* number of extra class bytes */
3166     int            win_extra;      /* number of window extra bytes */
3167     client_ptr_t   client_ptr;     /* pointer to class in client address space */
3168     data_size_t    name_offset;    /* base class name offset for specified atom */
3169     VARARG(name,unicode_str);      /* class name */
3170 @REPLY
3171     atom_t         atom;           /* resulting class atom */
3172 @END
3173
3174
3175 /* Destroy a window class */
3176 @REQ(destroy_class)
3177     atom_t         atom;           /* class atom */
3178     mod_handle_t   instance;       /* module instance */
3179     VARARG(name,unicode_str);      /* class name */
3180 @REPLY
3181     client_ptr_t   client_ptr;     /* pointer to class in client address space */
3182 @END
3183
3184
3185 /* Set some information in a class */
3186 @REQ(set_class_info)
3187     user_handle_t  window;         /* handle to the window */
3188     unsigned int   flags;          /* flags for info to set (see below) */
3189     atom_t         atom;           /* class atom */
3190     unsigned int   style;          /* class style */
3191     int            win_extra;      /* number of window extra bytes */
3192     mod_handle_t   instance;       /* module instance */
3193     int            extra_offset;   /* offset to set in extra bytes */
3194     data_size_t    extra_size;     /* size to set in extra bytes */
3195     lparam_t       extra_value;    /* value to set in extra bytes */
3196 @REPLY
3197     atom_t         old_atom;       /* previous class atom */
3198     atom_t         base_atom;      /* base class atom */
3199     mod_handle_t   old_instance;   /* previous module instance */
3200     lparam_t       old_extra_value; /* old value in extra bytes */
3201     unsigned int   old_style;      /* previous class style */
3202     int            old_extra;      /* previous number of class extra bytes */
3203     int            old_win_extra;  /* previous number of window extra bytes */
3204 @END
3205 #define SET_CLASS_ATOM      0x0001
3206 #define SET_CLASS_STYLE     0x0002
3207 #define SET_CLASS_WINEXTRA  0x0004
3208 #define SET_CLASS_INSTANCE  0x0008
3209 #define SET_CLASS_EXTRA     0x0010
3210
3211
3212 /* Open the clipboard */
3213 @REQ(open_clipboard)
3214     user_handle_t  window;         /* clipboard window */
3215 @REPLY
3216     user_handle_t  owner;          /* current clipboard owner */
3217 @END
3218
3219
3220 /* Close the clipboard */
3221 @REQ(close_clipboard)
3222 @REPLY
3223     user_handle_t  viewer;         /* first clipboard viewer */
3224     user_handle_t  owner;          /* current clipboard owner */
3225 @END
3226
3227
3228 /* Empty the clipboard and grab ownership */
3229 @REQ(empty_clipboard)
3230 @END
3231
3232
3233 /* Add a data format to the clipboard */
3234 @REQ(set_clipboard_data)
3235     unsigned int   format;         /* clipboard format of the data */
3236     unsigned int   lcid;           /* locale id to use for synthesizing text formats */
3237     VARARG(data,bytes);            /* data contents */
3238 @REPLY
3239     unsigned int   seqno;          /* sequence number for the set data */
3240 @END
3241
3242
3243 /* Fetch a data format from the clipboard */
3244 @REQ(get_clipboard_data)
3245     unsigned int   format;         /* clipboard format of the data */
3246     int            render;         /* will we try to render it if missing? */
3247     int            cached;         /* do we already have it in the client-side cache? */
3248     unsigned int   seqno;          /* sequence number for the data in the cache */
3249 @REPLY
3250     unsigned int   from;           /* for synthesized data, format to generate it from */
3251     user_handle_t  owner;          /* clipboard owner for delayed-rendered formats */
3252     unsigned int   seqno;          /* sequence number for the originally set data */
3253     data_size_t    total;          /* total data size */
3254     VARARG(data,bytes);            /* data contents */
3255 @END
3256
3257
3258 /* Retrieve a list of available formats */
3259 @REQ(get_clipboard_formats)
3260     unsigned int   format;         /* specific format to query, return all if 0 */
3261 @REPLY
3262     unsigned int   count;          /* count of available formats */
3263     VARARG(formats,uints);         /* array of available formats */
3264 @END
3265
3266
3267 /* Retrieve the next available format */
3268 @REQ(enum_clipboard_formats)
3269     unsigned int   previous;       /* previous format, or first if 0 */
3270 @REPLY
3271     unsigned int   format;         /* next format */
3272 @END
3273
3274
3275 /* Release ownership of the clipboard */
3276 @REQ(release_clipboard)
3277     user_handle_t  owner;          /* clipboard owner to release */
3278 @REPLY
3279     user_handle_t  viewer;         /* first clipboard viewer */
3280     user_handle_t  owner;          /* current clipboard owner */
3281 @END
3282
3283
3284 /* Get clipboard information */
3285 @REQ(get_clipboard_info)
3286 @REPLY
3287     user_handle_t  window;         /* clipboard window */
3288     user_handle_t  owner;          /* clipboard owner */
3289     user_handle_t  viewer;         /* clipboard viewer */
3290     unsigned int   seqno;          /* current sequence number */
3291 @END
3292
3293
3294 /* Set the clipboard viewer window */
3295 @REQ(set_clipboard_viewer)
3296     user_handle_t  viewer;         /* clipboard viewer */
3297     user_handle_t  previous;       /* if non-zero, check that this was the previous viewer */
3298 @REPLY
3299     user_handle_t  old_viewer;     /* previous clipboard viewer */
3300     user_handle_t  owner;          /* clipboard owner */
3301 @END
3302
3303
3304 /* Add a clipboard listener window */
3305 @REQ(add_clipboard_listener)
3306     user_handle_t  window;         /* clipboard listener window */
3307 @END
3308
3309
3310 /* Remove a clipboard listener window */
3311 @REQ(remove_clipboard_listener)
3312     user_handle_t  window;         /* clipboard listener window */
3313 @END
3314
3315
3316 /* Open a security token */
3317 @REQ(open_token)
3318     obj_handle_t   handle;    /* handle to the thread or process */
3319     unsigned int   access;    /* access rights to the new token */
3320     unsigned int   attributes;/* object attributes */
3321     unsigned int   flags;     /* flags (see below) */
3322 @REPLY
3323     obj_handle_t   token;    /* handle to the token */
3324 @END
3325 #define OPEN_TOKEN_THREAD   1
3326 #define OPEN_TOKEN_AS_SELF  2
3327
3328
3329 /* Set/get the global windows */
3330 @REQ(set_global_windows)
3331     unsigned int   flags;               /* flags for fields to set (see below) */
3332     user_handle_t  shell_window;        /* handle to the new shell window */
3333     user_handle_t  shell_listview;      /* handle to the new shell listview window */
3334     user_handle_t  progman_window;      /* handle to the new program manager window */
3335     user_handle_t  taskman_window;      /* handle to the new task manager window */
3336 @REPLY
3337     user_handle_t  old_shell_window;    /* handle to the shell window */
3338     user_handle_t  old_shell_listview;  /* handle to the shell listview window */
3339     user_handle_t  old_progman_window;  /* handle to the new program manager window */
3340     user_handle_t  old_taskman_window;  /* handle to the new task manager window */
3341 @END
3342 #define SET_GLOBAL_SHELL_WINDOWS   0x01  /* set both main shell and listview windows */
3343 #define SET_GLOBAL_PROGMAN_WINDOW  0x02
3344 #define SET_GLOBAL_TASKMAN_WINDOW  0x04
3345
3346 /* Adjust the privileges held by a token */
3347 @REQ(adjust_token_privileges)
3348     obj_handle_t  handle; /* handle to the token */
3349     int           disable_all; /* disable all privileges? */
3350     int           get_modified_state; /* get modified privileges? */
3351     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to enable/disable/remove */
3352 @REPLY
3353     unsigned int  len; /* total length in bytes required to store token privileges */
3354     VARARG(privileges,LUID_AND_ATTRIBUTES); /* modified privileges */
3355 @END
3356
3357 /* Retrieves the set of privileges held by or available to a token */
3358 @REQ(get_token_privileges)
3359     obj_handle_t  handle; /* handle to the token */
3360 @REPLY
3361     unsigned int  len; /* total length in bytes required to store token privileges */
3362     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
3363 @END
3364
3365 /* Check the token has the required privileges */
3366 @REQ(check_token_privileges)
3367     obj_handle_t  handle; /* handle to the token */
3368     int           all_required; /* are all the privileges required for the check to succeed? */
3369     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges to check */
3370 @REPLY
3371     int           has_privileges; /* does the token have the required privileges? */
3372     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges held by or available to a token */
3373 @END
3374
3375 @REQ(duplicate_token)
3376     obj_handle_t  handle;        /* handle to the token to duplicate */
3377     unsigned int  access;        /* access rights to the new token */
3378     int           primary;       /* is the new token to be a primary one? */
3379     int           impersonation_level; /* impersonation level of the new token */
3380     VARARG(objattr,object_attributes); /* object attributes */
3381 @REPLY
3382     obj_handle_t  new_handle; /* duplicated handle */
3383 @END
3384
3385 @REQ(access_check)
3386     obj_handle_t    handle; /* handle to the token */
3387     unsigned int    desired_access; /* desired access to the object */
3388     unsigned int    mapping_read; /* mapping from generic read to specific rights */
3389     unsigned int    mapping_write; /* mapping from generic write to specific rights */
3390     unsigned int    mapping_execute; /* mapping from generic execute to specific rights */
3391     unsigned int    mapping_all; /* mapping from generic all to specific rights */
3392     VARARG(sd,security_descriptor); /* security descriptor to check */
3393 @REPLY
3394     unsigned int    access_granted; /* access rights actually granted */
3395     unsigned int    access_status; /* was access granted? */
3396     unsigned int    privileges_len; /* length needed to store privileges */
3397     VARARG(privileges,LUID_AND_ATTRIBUTES); /* privileges used during access check */
3398 @END
3399
3400 @REQ(get_token_sid)
3401     obj_handle_t    handle;       /* handle to the token */
3402     unsigned int    which_sid;    /* which SID to retrieve from the token */
3403 @REPLY
3404     data_size_t     sid_len;      /* length needed to store sid */
3405     VARARG(sid,SID);              /* the sid specified by which_sid from the token */
3406 @END
3407
3408 @REQ(get_token_groups)
3409     obj_handle_t    handle;       /* handle to the token */
3410 @REPLY
3411     data_size_t     user_len;     /* length needed to store user */
3412     VARARG(user,token_groups);    /* groups the token's user belongs to */
3413 @END
3414
3415 @REQ(get_token_default_dacl)
3416     obj_handle_t    handle;     /* handle to the token */
3417 @REPLY
3418     data_size_t     acl_len;    /* length needed to store access control list */
3419     VARARG(acl,ACL);            /* access control list */
3420 @END
3421
3422 @REQ(set_token_default_dacl)
3423     obj_handle_t    handle;     /* handle to the token */
3424     VARARG(acl,ACL);            /* default dacl to set */
3425 @END
3426
3427 @REQ(set_security_object)
3428     obj_handle_t    handle;       /* handle to the object */
3429     unsigned int    security_info; /* which parts of security descriptor to set */
3430     VARARG(sd,security_descriptor); /* security descriptor to set */
3431 @END
3432
3433 @REQ(get_security_object)
3434     obj_handle_t    handle;       /* handle to the object */
3435     unsigned int    security_info; /* which parts of security descriptor to get */
3436 @REPLY
3437     unsigned int    sd_len;         /* buffer size needed for sd */
3438     VARARG(sd,security_descriptor); /* retrieved security descriptor */
3439 @END
3440
3441
3442 struct handle_info
3443 {
3444     process_id_t owner;
3445     obj_handle_t handle;
3446     unsigned int access;
3447 };
3448
3449 /* Return a list of all opened handles */
3450 @REQ(get_system_handles)
3451 @REPLY
3452     unsigned int    count;        /* number of handles */
3453     VARARG(data,handle_infos);    /* array of handle_infos */
3454 @END
3455
3456
3457 /* Create a mailslot */
3458 @REQ(create_mailslot)
3459     unsigned int   access;        /* wanted access rights */
3460     timeout_t      read_timeout;
3461     unsigned int   max_msgsize;
3462     VARARG(objattr,object_attributes); /* object attributes */
3463 @REPLY
3464     obj_handle_t   handle;        /* handle to the mailslot */
3465 @END
3466
3467
3468 /* Set mailslot information */
3469 @REQ(set_mailslot_info)
3470     obj_handle_t   handle;        /* handle to the mailslot */
3471     timeout_t      read_timeout;
3472     unsigned int   flags;
3473 @REPLY
3474     timeout_t      read_timeout;
3475     unsigned int   max_msgsize;
3476 @END
3477 #define MAILSLOT_SET_READ_TIMEOUT  1
3478
3479
3480 /* Create a directory object */
3481 @REQ(create_directory)
3482     unsigned int   access;        /* access flags */
3483     VARARG(objattr,object_attributes); /* object attributes */
3484 @REPLY
3485     obj_handle_t   handle;        /* handle to the directory */
3486 @END
3487
3488
3489 /* Open a directory object */
3490 @REQ(open_directory)
3491     unsigned int   access;        /* access flags */
3492     unsigned int   attributes;    /* object attributes */
3493     obj_handle_t   rootdir;       /* root directory */
3494     VARARG(directory_name,unicode_str); /* Directory name */
3495 @REPLY
3496     obj_handle_t   handle;        /* handle to the directory */
3497 @END
3498
3499
3500 /* Get a directory entry by index */
3501 @REQ(get_directory_entry)
3502     obj_handle_t   handle;             /* handle to the directory */
3503     unsigned int   index;              /* entry index */
3504 @REPLY
3505     data_size_t    name_len;           /* length of the entry name in bytes */
3506     VARARG(name,unicode_str,name_len); /* entry name */
3507     VARARG(type,unicode_str);          /* entry type */
3508 @END
3509
3510
3511 /* Create a symbolic link object */
3512 @REQ(create_symlink)
3513     unsigned int   access;        /* access flags */
3514     VARARG(objattr,object_attributes); /* object attributes */
3515     VARARG(target_name,unicode_str);   /* target name */
3516 @REPLY
3517     obj_handle_t   handle;        /* handle to the symlink */
3518 @END
3519
3520
3521 /* Open a symbolic link object */
3522 @REQ(open_symlink)
3523     unsigned int   access;        /* access flags */
3524     unsigned int   attributes;    /* object attributes */
3525     obj_handle_t   rootdir;       /* root directory */
3526     VARARG(name,unicode_str);     /* symlink name */
3527 @REPLY
3528     obj_handle_t   handle;        /* handle to the symlink */
3529 @END
3530
3531
3532 /* Query a symbolic link object */
3533 @REQ(query_symlink)
3534     obj_handle_t   handle;        /* handle to the symlink */
3535 @REPLY
3536     data_size_t    total;         /* total needed size for name */
3537     VARARG(target_name,unicode_str); /* target name */
3538 @END
3539
3540
3541 /* Query basic object information */
3542 @REQ(get_object_info)
3543     obj_handle_t   handle;        /* handle to the object */
3544 @REPLY
3545     unsigned int   access;        /* granted access mask */
3546     unsigned int   ref_count;     /* object ref count */
3547     unsigned int   handle_count;  /* object handle count */
3548     data_size_t    total;         /* total needed size for name */
3549     VARARG(name,unicode_str);     /* object name */
3550 @END
3551
3552
3553 /* Query object type name information */
3554 @REQ(get_object_type)
3555     obj_handle_t   handle;        /* handle to the object */
3556 @REPLY
3557     data_size_t    total;         /* needed size for type name */
3558     VARARG(type,unicode_str);     /* type name */
3559 @END
3560
3561
3562 /* Unlink a named object */
3563 @REQ(unlink_object)
3564     obj_handle_t   handle;        /* handle to the object */
3565 @END
3566
3567
3568 /* Query the impersonation level of an impersonation token */
3569 @REQ(get_token_impersonation_level)
3570     obj_handle_t   handle;        /* handle to the object */
3571 @REPLY
3572     int            impersonation_level; /* impersonation level of the impersonation token */
3573 @END
3574
3575 /* Allocate a locally-unique identifier */
3576 @REQ(allocate_locally_unique_id)
3577 @REPLY
3578     luid_t         luid;
3579 @END
3580
3581
3582 /* Create a device manager */
3583 @REQ(create_device_manager)
3584     unsigned int access;          /* wanted access rights */
3585     unsigned int attributes;      /* object attributes */
3586 @REPLY
3587     obj_handle_t handle;          /* handle to the device */
3588 @END
3589
3590
3591 /* Create a device */
3592 @REQ(create_device)
3593     unsigned int access;          /* wanted access rights */
3594     unsigned int attributes;      /* object attributes */
3595     obj_handle_t rootdir;         /* root directory */
3596     client_ptr_t user_ptr;        /* opaque ptr for use by client */
3597     obj_handle_t manager;         /* device manager */
3598     VARARG(name,unicode_str);     /* object name */
3599 @REPLY
3600     obj_handle_t handle;          /* handle to the device */
3601 @END
3602
3603
3604 /* Delete a device */
3605 @REQ(delete_device)
3606     obj_handle_t handle;          /* handle to the device */
3607 @END
3608
3609
3610 /* Retrieve the next pending device irp request */
3611 @REQ(get_next_device_request)
3612     obj_handle_t manager;         /* handle to the device manager */
3613     obj_handle_t prev;            /* handle to the previous irp */
3614     unsigned int status;          /* status of the previous irp */
3615 @REPLY
3616     irp_params_t params;          /* irp parameters */
3617     obj_handle_t next;            /* handle to the next irp */
3618     process_id_t client_pid;      /* pid of process calling irp */
3619     thread_id_t  client_tid;      /* tid of thread calling irp */
3620     data_size_t  in_size;         /* total needed input size */
3621     data_size_t  out_size;        /* needed output size */
3622     VARARG(next_data,bytes);      /* input data of the next irp */
3623 @END
3624
3625
3626 /* Make the current process a system process */
3627 @REQ(make_process_system)
3628 @REPLY
3629     obj_handle_t event;           /* event signaled when all user processes have exited */
3630 @END
3631
3632
3633 /* Get detailed fixed-size information about a token */
3634 @REQ(get_token_statistics)
3635     obj_handle_t   handle;        /* handle to the object */
3636 @REPLY
3637     luid_t         token_id;      /* locally-unique identifier of the token */
3638     luid_t         modified_id;   /* locally-unique identifier of the modified version of the token */
3639     int            primary;       /* is the token primary or impersonation? */
3640     int            impersonation_level; /* level of impersonation */
3641     int            group_count;   /* the number of groups the token is a member of */
3642     int            privilege_count; /* the number of privileges the token has */
3643 @END
3644
3645
3646 /* Create I/O completion port */
3647 @REQ(create_completion)
3648     unsigned int access;          /* desired access to a port */
3649     unsigned int concurrent;      /* max number of concurrent active threads */
3650     VARARG(objattr,object_attributes); /* object attributes */
3651 @REPLY
3652     obj_handle_t handle;          /* port handle */
3653 @END
3654
3655
3656 /* Open I/O completion port */
3657 @REQ(open_completion)
3658     unsigned int access;          /* desired access to a port */
3659     unsigned int attributes;      /* object attributes */
3660     obj_handle_t rootdir;         /* root directory */
3661     VARARG(filename,unicode_str); /* port name */
3662 @REPLY
3663     obj_handle_t handle;          /* port handle */
3664 @END
3665
3666
3667 /* add completion to completion port */
3668 @REQ(add_completion)
3669     obj_handle_t  handle;         /* port handle */
3670     apc_param_t   ckey;           /* completion key */
3671     apc_param_t   cvalue;         /* completion value */
3672     apc_param_t   information;    /* IO_STATUS_BLOCK Information */
3673     unsigned int  status;         /* completion result */
3674 @END
3675
3676
3677 /* get completion from completion port queue */
3678 @REQ(remove_completion)
3679     obj_handle_t handle;          /* port handle */
3680 @REPLY
3681     apc_param_t   ckey;           /* completion key */
3682     apc_param_t   cvalue;         /* completion value */
3683     apc_param_t   information;    /* IO_STATUS_BLOCK Information */
3684     unsigned int  status;         /* completion result */
3685 @END
3686
3687
3688 /* get completion queue depth */
3689 @REQ(query_completion)
3690     obj_handle_t  handle;         /* port handle */
3691 @REPLY
3692     unsigned int  depth;          /* completion queue depth */
3693 @END
3694
3695
3696 /* associate object with completion port */
3697 @REQ(set_completion_info)
3698     obj_handle_t  handle;         /* object handle */
3699     apc_param_t   ckey;           /* completion key */
3700     obj_handle_t  chandle;        /* port handle */
3701 @END
3702
3703
3704 /* check for associated completion and push msg */
3705 @REQ(add_fd_completion)
3706     obj_handle_t   handle;        /* async' object */
3707     apc_param_t    cvalue;        /* completion value */
3708     apc_param_t    information;   /* IO_STATUS_BLOCK Information */
3709     unsigned int   status;        /* completion status */
3710     int            async;         /* completion is an async result */
3711 @END
3712
3713
3714 /* set fd completion information */
3715 @REQ(set_fd_completion_mode)
3716     obj_handle_t handle;          /* handle to a file or directory */
3717     unsigned int flags;           /* completion notification flags */
3718 @END
3719
3720
3721 /* set fd disposition information */
3722 @REQ(set_fd_disp_info)
3723     obj_handle_t handle;          /* handle to a file or directory */
3724     int          unlink;          /* whether to unlink file on close */
3725 @END
3726
3727
3728 /* set fd name information */
3729 @REQ(set_fd_name_info)
3730     obj_handle_t handle;          /* handle to a file or directory */
3731     obj_handle_t rootdir;         /* root directory */
3732     int          link;            /* link instead of renaming */
3733     VARARG(filename,string);      /* new file name */
3734 @END
3735
3736
3737 /* Retrieve layered info for a window */
3738 @REQ(get_window_layered_info)
3739     user_handle_t  handle;        /* handle to the window */
3740 @REPLY
3741     unsigned int   color_key;     /* color key */
3742     unsigned int   alpha;         /* alpha (0..255) */
3743     unsigned int   flags;         /* LWA_* flags */
3744 @END
3745
3746
3747 /* Set layered info for a window */
3748 @REQ(set_window_layered_info)
3749     user_handle_t  handle;        /* handle to the window */
3750     unsigned int   color_key;     /* color key */
3751     unsigned int   alpha;         /* alpha (0..255) */
3752     unsigned int   flags;         /* LWA_* flags */
3753 @END
3754
3755
3756 /* Allocate an arbitrary user handle */
3757 @REQ(alloc_user_handle)
3758 @REPLY
3759     user_handle_t  handle;        /* allocated handle */
3760 @END
3761
3762
3763 /* Free an arbitrary user handle */
3764 @REQ(free_user_handle)
3765     user_handle_t  handle;        /* handle to free*/
3766 @END
3767
3768
3769 /* Set/get the current cursor */
3770 @REQ(set_cursor)
3771     unsigned int   flags;         /* flags for fields to set (see below) */
3772     user_handle_t  handle;        /* handle to the cursor */
3773     int            show_count;    /* show count increment/decrement */
3774     int            x;             /* cursor position */
3775     int            y;
3776     rectangle_t    clip;          /* cursor clip rectangle */
3777     unsigned int   clip_msg;      /* message to post on cursor clip changes */
3778 @REPLY
3779     user_handle_t  prev_handle;   /* previous handle */
3780     int            prev_count;    /* previous show count */
3781     int            prev_x;        /* previous position */
3782     int            prev_y;
3783     int            new_x;         /* new position */
3784     int            new_y;
3785     rectangle_t    new_clip;      /* new clip rectangle */
3786     unsigned int   last_change;   /* time of last position change */
3787 @END
3788 #define SET_CURSOR_HANDLE 0x01
3789 #define SET_CURSOR_COUNT  0x02
3790 #define SET_CURSOR_POS    0x04
3791 #define SET_CURSOR_CLIP   0x08
3792 #define SET_CURSOR_NOCLIP 0x10
3793
3794
3795 /* Modify the list of registered rawinput devices */
3796 @REQ(update_rawinput_devices)
3797     VARARG(devices,rawinput_devices);
3798 @END
3799
3800
3801 /* Retrieve the suspended context of a thread */
3802 @REQ(get_suspend_context)
3803 @REPLY
3804     VARARG(context,context);   /* thread context */
3805 @END
3806
3807
3808 /* Store the suspend context of a thread */
3809 @REQ(set_suspend_context)
3810     VARARG(context,context);   /* thread context */
3811 @END
3812
3813
3814 /* Create a new job object */
3815 @REQ(create_job)
3816     unsigned int access;          /* wanted access rights */
3817     VARARG(objattr,object_attributes); /* object attributes */
3818 @REPLY
3819     obj_handle_t handle;          /* handle to the job */
3820 @END
3821
3822
3823 /* Open a job object */
3824 @REQ(open_job)
3825     unsigned int access;          /* wanted access rights */
3826     unsigned int attributes;      /* object attributes */
3827     obj_handle_t rootdir;         /* root directory */
3828     VARARG(name,unicode_str);     /* object name */
3829 @REPLY
3830     obj_handle_t handle;          /* handle to the job */
3831 @END
3832
3833
3834 /* Assign a job object to a process */
3835 @REQ(assign_job)
3836     obj_handle_t job;             /* handle to the job */
3837     obj_handle_t process;         /* handle to the process */
3838 @END
3839
3840
3841 /* Check if a process is associated with a job */
3842 @REQ(process_in_job)
3843     obj_handle_t job;             /* handle to the job */
3844     obj_handle_t process;         /* handle to the process */
3845 @END
3846
3847
3848 /* Set limit flags on a job */
3849 @REQ(set_job_limits)
3850     obj_handle_t handle;          /* handle to the job */
3851     unsigned int limit_flags;     /* new limit flags */
3852 @END
3853
3854
3855 /* Set new completion port for a job */
3856 @REQ(set_job_completion_port)
3857     obj_handle_t job;             /* handle to the job */
3858     obj_handle_t port;            /* handle to the completion port */
3859     client_ptr_t key;             /* key to send with completion messages */
3860 @END
3861
3862
3863 /* Terminate all processes associated with the job  */
3864 @REQ(terminate_job)
3865     obj_handle_t handle;          /* handle to the job */
3866     int          status;          /* process exit code */
3867 @END