mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-28 07:04:00 +08:00
a08b9f2f22
The opening comment mark '/**' is used for highlighting the beginning of kernel-doc comments. There are files in sound/pci/ctxfi which follow this syntax in their file headers, i.e. start with '/**' like comments, which causes unexpected warnings from kernel-doc. E.g., running scripts/kernel-doc -none on sound/pci/ctxfi/ctresource.c causes this warning: "warning: wrong kernel-doc identifier on line: * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved." Similarly for other files too. Provide a simple fix by replacing the kernel-doc like comment syntax with general format, i.e. "/*", to prevent kernel-doc from parsing it. Signed-off-by: Aditya Srivastava <yashsri421@gmail.com> Acked-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20210317203932.23993-1-yashsri421@gmail.com Signed-off-by: Takashi Iwai <tiwai@suse.de>
96 lines
2.7 KiB
C
96 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
|
|
*
|
|
* @File ctamixer.h
|
|
*
|
|
* @Brief
|
|
* This file contains the definition of the Audio Mixer
|
|
* resource management object.
|
|
*
|
|
* @Author Liu Chun
|
|
* @Date May 21 2008
|
|
*/
|
|
|
|
#ifndef CTAMIXER_H
|
|
#define CTAMIXER_H
|
|
|
|
#include "ctresource.h"
|
|
#include <linux/spinlock.h>
|
|
#include <sound/core.h>
|
|
|
|
/* Define the descriptor of a summation node resource */
|
|
struct sum {
|
|
struct rsc rsc; /* Basic resource info */
|
|
unsigned char idx[8];
|
|
};
|
|
|
|
/* Define sum resource request description info */
|
|
struct sum_desc {
|
|
unsigned int msr;
|
|
};
|
|
|
|
struct sum_mgr {
|
|
struct rsc_mgr mgr; /* Basic resource manager info */
|
|
struct snd_card *card; /* pointer to this card */
|
|
spinlock_t mgr_lock;
|
|
|
|
/* request one sum resource */
|
|
int (*get_sum)(struct sum_mgr *mgr,
|
|
const struct sum_desc *desc, struct sum **rsum);
|
|
/* return one sum resource */
|
|
int (*put_sum)(struct sum_mgr *mgr, struct sum *sum);
|
|
};
|
|
|
|
/* Constructor and destructor of daio resource manager */
|
|
int sum_mgr_create(struct hw *hw, struct sum_mgr **rsum_mgr);
|
|
int sum_mgr_destroy(struct sum_mgr *sum_mgr);
|
|
|
|
/* Define the descriptor of a amixer resource */
|
|
struct amixer_rsc_ops;
|
|
|
|
struct amixer {
|
|
struct rsc rsc; /* Basic resource info */
|
|
unsigned char idx[8];
|
|
struct rsc *input; /* pointer to a resource acting as source */
|
|
struct sum *sum; /* Put amixer output to this summation node */
|
|
const struct amixer_rsc_ops *ops; /* AMixer specific operations */
|
|
};
|
|
|
|
struct amixer_rsc_ops {
|
|
int (*set_input)(struct amixer *amixer, struct rsc *rsc);
|
|
int (*set_scale)(struct amixer *amixer, unsigned int scale);
|
|
int (*set_invalid_squash)(struct amixer *amixer, unsigned int iv);
|
|
int (*set_sum)(struct amixer *amixer, struct sum *sum);
|
|
int (*commit_write)(struct amixer *amixer);
|
|
/* Only for interleaved recording */
|
|
int (*commit_raw_write)(struct amixer *amixer);
|
|
int (*setup)(struct amixer *amixer, struct rsc *input,
|
|
unsigned int scale, struct sum *sum);
|
|
int (*get_scale)(struct amixer *amixer);
|
|
};
|
|
|
|
/* Define amixer resource request description info */
|
|
struct amixer_desc {
|
|
unsigned int msr;
|
|
};
|
|
|
|
struct amixer_mgr {
|
|
struct rsc_mgr mgr; /* Basic resource manager info */
|
|
struct snd_card *card; /* pointer to this card */
|
|
spinlock_t mgr_lock;
|
|
|
|
/* request one amixer resource */
|
|
int (*get_amixer)(struct amixer_mgr *mgr,
|
|
const struct amixer_desc *desc,
|
|
struct amixer **ramixer);
|
|
/* return one amixer resource */
|
|
int (*put_amixer)(struct amixer_mgr *mgr, struct amixer *amixer);
|
|
};
|
|
|
|
/* Constructor and destructor of amixer resource manager */
|
|
int amixer_mgr_create(struct hw *hw, struct amixer_mgr **ramixer_mgr);
|
|
int amixer_mgr_destroy(struct amixer_mgr *amixer_mgr);
|
|
|
|
#endif /* CTAMIXER_H */
|