Unix/Linux Go Back    


X11R7.4 - man page for xvgrabport (x11r4 section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


XvGrabPort(3)									    XvGrabPort(3)

Name
       XvGrabPort - lock port for exclusive use by client

Syntax
       #include <X11/extensions/Xvlib.h>

       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(3)  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  XvIn-
       validTime 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  processed: XvGrabPort(3), XvUngrabPort(3), XvPutVideo(3), XvPut-
       Still(3), XvGetVideo(3), XvGetStill(3).

       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.

Returned Values
       [Success]
	       Returned if XvGrabPort(3) 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(3) failed to allocate memory to process the request.

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

See Also
       XvUngrabPort(3) XvVideoNotify(3)

X Version 11				   libXv 1.0.4				    XvGrabPort(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:45 AM.