gstreamer/gst/gstpoll.h
Guillaume Desmottes b2593133b5 poll: add API to watch for POLLPRI
Windows doesn't seem to have an equivalent of POLLPRI so disabled those
functions on this platform.

This API can be used, for example, to wait for video4linux events which
are using POLLPRI.

https://bugzilla.gnome.org/show_bug.cgi?id=794977
2018-06-08 11:53:55 -04:00

133 lines
3.5 KiB
C

/* GStreamer
* Copyright (C) 1999 Erik Walthinsen <omega@cse.ogi.edu>
* Copyright (C) 2004 Wim Taymans <wim.taymans@gmail.com>
* Copyright (C) 2007 Peter Kjellerstedt <pkj@axis.com>
*
* gstpoll.h: File descriptor set
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GST_POLL_H__
#define __GST_POLL_H__
#include <glib.h>
#include <glib-object.h>
#include <gst/gstclock.h>
G_BEGIN_DECLS
/**
* GstPoll:
*
* A set of file/network descriptors.
*/
typedef struct _GstPoll GstPoll;
/**
* GstPollFD:
* @fd: a file descriptor
*
* A file descriptor object.
*/
typedef struct {
int fd;
/*< private >*/
gint idx;
} GstPollFD;
/**
* GST_POLL_FD_INIT:
*
* A #GstPollFD must be initialized with this macro, before it can be
* used. This macro can used be to initialize a variable, but it cannot
* be assigned to a variable. In that case you have to use
* gst_poll_fd_init().
*/
#define GST_POLL_FD_INIT { -1, -1 }
GST_API
GstPoll* gst_poll_new (gboolean controllable) G_GNUC_MALLOC;
GST_API
GstPoll* gst_poll_new_timer (void) G_GNUC_MALLOC;
GST_API
void gst_poll_free (GstPoll *set);
GST_API
void gst_poll_get_read_gpollfd (GstPoll *set, GPollFD *fd);
GST_API
void gst_poll_fd_init (GstPollFD *fd);
GST_API
gboolean gst_poll_add_fd (GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_remove_fd (GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_ctl_write (GstPoll *set, GstPollFD *fd, gboolean active);
GST_API
gboolean gst_poll_fd_ctl_read (GstPoll *set, GstPollFD *fd, gboolean active);
GST_API
gboolean gst_poll_fd_ctl_pri (GstPoll *set, GstPollFD *fd, gboolean active);
GST_API
void gst_poll_fd_ignored (GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_has_closed (const GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_has_error (const GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_can_read (const GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_can_write (const GstPoll *set, GstPollFD *fd);
GST_API
gboolean gst_poll_fd_has_pri (const GstPoll *set, GstPollFD *fd);
GST_API
gint gst_poll_wait (GstPoll *set, GstClockTime timeout);
GST_API
gboolean gst_poll_set_controllable (GstPoll *set, gboolean controllable);
GST_API
void gst_poll_restart (GstPoll *set);
GST_API
void gst_poll_set_flushing (GstPoll *set, gboolean flushing);
GST_API
gboolean gst_poll_write_control (GstPoll *set);
GST_API
gboolean gst_poll_read_control (GstPoll *set) G_GNUC_WARN_UNUSED_RESULT;
G_END_DECLS
#endif /* __GST_POLL_H__ */