1XkbQueryExtension(3)             XKB FUNCTIONS            XkbQueryExtension(3)
2
3
4

NAME

6       XkbQueryExtension  -  Determines the compatibility of a library at run‐
7       time.
8

SYNOPSIS

10       Bool   XkbQueryExtension   (Display   *dpy,   int   *opcode_rtrn,   int
11              *event_rtrn,    int    *error_rtrn,   int   *major_in_out,   int
12              *minor_in_out);
13

ARGUMENTS

15       dpy    connection to the X server
16
17       opcode_rtrn
18              backfilled with the major extension opcode
19
20       event_rtrn
21              backfilled with the extension base event code
22
23       error_rtrn
24              backfilled with the extension base error code
25
26       major_in_out
27              compile time lib major version in, server major version out
28
29       minor_in_out
30              compile time lib min version in, server minor version out
31

DESCRIPTION

33       Call XkbQueryExtension to check for the presence and  compatibility  of
34       the extension in the server and to initialize the extension. Because of
35       potential version mismatches, you  cannot  use  the  generic  extension
36       mechanism functions ( XQueryExtension and XInitExtension ) for checking
37       for the presence of, and initializing the Xkb extension.
38
39       You must call XkbQueryExtension  or  XkbOpenDisplay  before  using  any
40       other  Xkb  library interfaces, unless such usage is explicitly allowed
41       in the interface description in  this  document.  The  exceptions  are:
42       XkbIgnoreExtension,  XkbLibraryVersion,  and  a handful of audible-bell
43       functions. You should not use any other Xkb functions if the  extension
44       is  not  present  or is uninitialized. In general, calls to Xkb library
45       functions made prior to initializing the Xkb extension cause  BadAccess
46       protocol errors.
47
48       XkbQueryExtension both determines whether a compatible Xkb extension is
49       present in the X server  and  initializes  the  extension  when  it  is
50       present.
51
52       The  XkbQueryExtension function determines whether a compatible version
53       of the X Keyboard Extension is present in the server. If  a  compatible
54       extension  is  present,  XkbQueryExtension  returns True; otherwise, it
55       returns False.
56
57       If a compatible version of Xkb is present,  XkbQueryExtension  initial‐
58       izes  the  extension.  It  backfills  the major opcode for the keyboard
59       extension in opcode_rtrn, the base event code in event_rtrn,  the  base
60       error  code  in  error_rtrn, and the major and minor version numbers of
61       the extension in major_in_out and minor_in_out.  The  major  opcode  is
62       reported  in  the req_major fields of some Xkb events. For a discussion
63       of the base event code.
64

RETURN VALUES

66       True           The XkbQueryExtension function returns True if it deter‐
67                      mines  a  compatible version of the X Keyboard Extension
68                      is present in the server.
69
70       False          The  XkbQueryExtension  function  returns  False  if  it
71                      determines a compatible version of the X Keyboard Exten‐
72                      sion is not present in the server.
73

SEE ALSO

75       XkbIgnoreExtension(3), XkbLibraryVersion(3), XkbOpenDisplay(3)
76
77
78
79X Version 11                     libX11 1.6.4             XkbQueryExtension(3)
Impressum