summaryrefslogtreecommitdiff
path: root/man/XIQueryVersion.txt
blob: 839c18ca138e3bfe806558fb6326c4e88ae25cdc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
XIQUERYVERSION(libmansuffix)
============================

NAME
----

   XIQueryVersion - announce and query the support XI2 version.

SYNOPSIS
--------

   #include <X11/extensions/XInput2.h>

   Status XIQueryVersion( Display *display,
                          int *major_version_inout,
                          int *minor_version_inout);
   
   display
          Specifies the connection to the X server.

   major_version_inout
          Specifies the client's supported XI2 version, and
          returns the server's supported version.

   minor_version_inout
          Specifies the client's supported XI2 version, and
          returns the server's supported version.

DESCRIPTION
-----------

   XIQueryVersion announces the client's supported XI2 version to
   the server and returns server's supported X Input version. Clients 
   are required to use XIQueryVersion instead of XGetExtensionVersion 
   if they use XI2 calls. The server may treat a client differently 
   depending on the supported version announced by the client.
   The major_version_inout must be 2 or greater, otherwise a BadValue 
   error occurs.

   If the server does not support XI2, XIQueryVersion returns BadRequest 
   to the client. Otherwise, XIQueryVersion returns Success. In both 
   cases major_version_inout and minor_version_inout are set to the 
   server's supported version.

   Consecutive calls to XIQueryVersion by the same client always return the
   first returned major.minor version. If the client requests a version
   lower than the first returned major.minor version in a subsequent call, a
   BadValue error occurs.

   XIQueryVersion can generate a BadValue error.

EXAMPLES
--------

        int rc;
        int major = 2;
        int minor = 0;

        rc = XIQueryVersion(dpy, &major, &minor);
        if (rc == Success)
            printf("XI2 supported. (%d.%d)\n", major, minor);
        else if (rc == BadRequest)
            printf("No XI2 support. (%d.%d only)\n", major, minor);
        else
            printf("Internal error\n");

DIAGNOSTICS
-----------

   BadValue
          A value is outside of the permitted range.