SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from PCLinuxOS libxv1-devel-1.0.1-3.pclo2005.mde.i586.rpm

XvGrabPort

Section: Misc. Reference Manual Pages (3x)
Updated: libXv 1.0.1
Index 

Name

XvGrabPort - lock port for exclusive use by client 

Syntax

#include <X11/extensions/Xvlib.h>

XvGrabPort(dpy, port, time)

Display *dpy;
XvPortID port;
Time time; 

Arguments

dpy
Specifies the display screen on which theXv Server is to accept requests from Xv clients. If thedisplay option is not specified, Xv uses the display screenspecified by your DISPLAY environment variable. The displayoption has the format hostname:number. Using two colons(::) instead of one (:) indicates that DECnet is to be usedfor transport.
port
Defines the port to be grabbed.
time
Specifies the request timestamp.
 

Description

XvGrabPort(3x) grabs a port. Once a client grabs a port, only that client can make video requeststo that port.

If the time is before the current port time, the XvGrabPort request isignored and XvInvalidTime is returned. If the port is already grabbed byanother client, XvAlreadyGrabbed is returned. Otherwise it returns astatus of Success. The port time is updated when the followingrequests are processed: XvGrabPort(3x), XvUngrabPort(3x),XvPutVideo(3x), XvPutStill(3x), XvGetVideo(3x), XvGetStill(3x).

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

Returned Values

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

Diagnostics

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

See Also

XvUngrabPort(3x) XvVideoNotify(3x)


 

Index

Name
Syntax
Arguments
Description
Returned Values
Diagnostics
See Also

This document was created byman2html,using the manual pages.