/* SPDX-License-Identifier: GPL-2.0-or-later */
#ifndef __SOUND_HWDEP_H
#define __SOUND_HWDEP_H

/*
 *  Hardware dependent layer 
 *  Copyright (c) by Jaroslav Kysela <[email protected]>
 */

#include <sound/asound.h>
#include <linux/poll.h>

struct snd_hwdep;

/* hwdep file ops; all ops can be NULL */
struct snd_hwdep_ops {
    long long (*llseek)(struct snd_hwdep *hw, struct file *file,
                long long offset, int orig);
    long (*read)(struct snd_hwdep *hw, char __user *buf,
             long count, loff_t *offset);
    long (*write)(struct snd_hwdep *hw, const char __user *buf,
              long count, loff_t *offset);
    int (*open)(struct snd_hwdep *hw, struct file * file);
    int (*release)(struct snd_hwdep *hw, struct file * file);
    __poll_t (*poll)(struct snd_hwdep *hw, struct file *file,
                 poll_table *wait);
    int (*ioctl)(struct snd_hwdep *hw, struct file *file,
             unsigned int cmd, unsigned long arg);
    int (*ioctl_compat)(struct snd_hwdep *hw, struct file *file,
                unsigned int cmd, unsigned long arg);
    int (*mmap)(struct snd_hwdep *hw, struct file *file,
            struct vm_area_struct *vma);
    int (*dsp_status)(struct snd_hwdep *hw,
              struct snd_hwdep_dsp_status *status);
    int (*dsp_load)(struct snd_hwdep *hw,
            struct snd_hwdep_dsp_image *image);
} __mutable_const;

struct snd_hwdep {
    struct snd_card *card;
    struct list_head list;
    int device;
    char id[32];
    char name[80];
    int iface;

#ifdef CONFIG_SND_OSSEMUL
    int oss_type;
    int ossreg;
#endif

    struct snd_hwdep_ops ops;
    wait_queue_head_t open_wait;
    void *private_data;
    void (*private_free) (struct snd_hwdep *hwdep);
    struct device *dev;

    struct mutex open_mutex;
    int used;            /* reference counter */
    unsigned int dsp_loaded;    /* bit fields of loaded dsp indices */
    unsigned int exclusive:1;    /* exclusive access mode */
};

extern int snd_hwdep_new(struct snd_card *card, char *id, int device,
             struct snd_hwdep **rhwdep);

#endif /* __SOUND_HWDEP_H */