XineramaGetData(3X11)

     NAME
          XineramaGetData - returns the state of the Xinerama
          extension

     SYNTAX
          #include <X11/extensions/Xinerama.h>

          Status XineramaGetData(
            Display        *dpy,
            int             screen_number,
            XRectangle    **rectangles_return,
            int            *count_return
          );

     ARGUMENTS
          dpy  Specifies the connection to the X server.

          screen_number
               Specifies a given Xinerama screen.

          rectangles_return
               Returns a list of rectangles corresponding to the
               physical underlying screens (frame buffers).

          count_return
               Returns the number of physical underlying screens
               (frame buffers).

     DESCRIPTION
          XineramaGetData returns the number of physical screens
          (frame buffers) and their geometry, for the Xinerama screen
          screen_number on the specified display connection dpy.

          It is the client task to free the resulting rectangle list,
          using XFree.

          The return status is True for no errors, False otherwise.

     DIAGNOSTICS
          BadAlloc
               The server failed to allocate the requested resource or
               server memory.

          BadValue
               screen_number is out of range.

     NOTES
          Currently, all the physical screens managed by the Xinerama
          enabled X server are combined into one active Xinerama
          screen. This means that screen_number should be 0.

          Xinerama is still not an Xorg standard. Thus, the interface
          may still evolve.

          XineramaGetData is a new interface replacing the deprecated
          XineramaGetInfo from IRIX 6.5.15 and onwards.

     SEE ALSO
          XFree(3X11), Xinerama(3X11), XineramaActive(3X11),
          XineramaGetCenterHint(3X11).