/*      $OpenBSD: sio_priv.h,v 1.15 2026/03/10 06:47:41 ratchov Exp $   */
/*
 * Copyright (c) 2008 Alexandre Ratchov <alex@caoua.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
#ifndef SNDIO_PRIV_H
#define SNDIO_PRIV_H

#include "sndio.h"

#define SIO_MAXNFDS     16

/*
 * private ``handle'' structure
 */
struct sio_hdl {
        struct sio_ops *ops;
        void (*move_cb)(void *, int);   /* call-back for realpos changes */
        void *move_addr;                /* user priv. data for move_cb */
        void (*vol_cb)(void *, unsigned); /* call-back for volume changes */
        void *vol_addr;                 /* user priv. data for vol_cb */
        void (*xrun_cb)(void *);        /* call-back for xruns */
        void *xrun_addr;                /* user priv. data for xrun_cb */
        unsigned mode;                  /* SIO_PLAY | SIO_REC */
        int started;                    /* true if started */
        int nbio;                       /* true if non-blocking io */
        int eof;                        /* true if error occurred */
        int rdrop;                      /* recorded bytes to drop */
        int wsil;                       /* silence to play */
        int rused;                      /* bytes used in read buffer */
        int wused;                      /* bytes used in write buffer */
        int xrun;                       /* xrun reported */
        int cpending;                   /* clock ticks not reported yet */
        long long cpos;                 /* clock since start */
        struct sio_par par;
#ifdef DEBUG
        unsigned long long pollcnt;     /* times sio_revents was called */
        long long start_nsec;
#endif
};

/*
 * operations every device should support
 */
struct sio_ops {
        void (*close)(struct sio_hdl *);
        int (*setpar)(struct sio_hdl *, struct sio_par *);
        int (*getpar)(struct sio_hdl *, struct sio_par *);
        int (*getcap)(struct sio_hdl *, struct sio_cap *);
        size_t (*write)(struct sio_hdl *, const void *, size_t);
        size_t (*read)(struct sio_hdl *, void *, size_t);
        int (*start)(struct sio_hdl *);
        int (*stop)(struct sio_hdl *);
        int (*flush)(struct sio_hdl *);
        int (*nfds)(struct sio_hdl *);
        int (*pollfd)(struct sio_hdl *, struct pollfd *, int);
        int (*revents)(struct sio_hdl *, struct pollfd *);
        int (*setvol)(struct sio_hdl *, unsigned);
        void (*getvol)(struct sio_hdl *);
};

struct sio_hdl *_sio_aucat_open(const char *, unsigned, int);
struct sio_hdl *_sio_sun_open(const char *, unsigned, int);
void _sio_create(struct sio_hdl *, struct sio_ops *, unsigned, int);
int  _sio_xrun(struct sio_hdl *);
void _sio_onmove_cb(struct sio_hdl *, int);
void _sio_onvol_cb(struct sio_hdl *, unsigned);
void _sio_onxrun_cb(struct sio_hdl *);
#ifdef DEBUG
void _sio_printpos(struct sio_hdl *);
#endif

#endif /* !defined(SNDIO_PRIV_H) */