Manual Pages for UNIX Operating System command usage for man XvGrabPort

libXv Functions                                   XvGrabPort(3xv)



NAME
     XvGrabPort - lock port for exclusive use by client

SYNOPSIS
     cc [ flag... ] file... -lXv [ library... ]
     #include 

     int XvGrabPort(Display *dpy, XvPortID port, Time time

ARGUMENTS
     dpy     Specifies the connection to the X server.

     port    Defines the port to be grabbed.

     time    Specifies the request timestamp.

DESCRIPTION
     XvGrabPort(3xv) grabs a port.  Once a client grabs  a  port,
     only that client can make video requests to that port.

     If the time is before the current port time, the  XvGrabPort
     request  is  ignored  and XvInvalidTime is returned.  If the
     port is already grabbed by another client,  XvAlreadyGrabbed
     is  returned. Otherwise it returns a status of Success.  The
     port time is updated when the following  requests  are  pro-
     cessed:          XvGrabPort(3xv),         XvUngrabPort(3xv),
     XvPutVideo(3xv),      XvPutStill(3xv),      XvGetVideo(3xv),
     XvGetStill(3xv).

     If the port is actively processing video for another client,
     the  video  is  preempted,  and  an XvVideoNotify event with
     detail XvPreempted is generated for its drawable.

RETURN VALUES
     [Success]
             Returned if XvGrabPort(3xv) completed successfully.

     [XvInvalidTime]
             Returned if requested time is older than the current
             port time.

     [XvAlreadyGrabbed]
             Returned if the port is already grabbed  by  another
             client.

     [XvBadExtension]
             Returned if the Xv extension is unavailable.

     [XvBadAlloc]
             Returned  if  XvGrabPort(3xv)  failed  to   allocate
             memory to process the request.




X Version 11        Last change: libXv 1.0.5                    1






libXv Functions                                   XvGrabPort(3xv)



DIAGNOSTICS
     [XvBadPort]    Generated if  the  requested  port  does  not
                    exist.

SEE ALSO
     XvUngrabPort(3xv), XvVideoNotify(3xv)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxv           |
    |_____________________________|_____________________________|
    | Interface Stability         | Volatile                    |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|

































X Version 11        Last change: libXv 1.0.5                    2