blob: d26c89693d2cf7171c4e904cc25021dcd70bb1bd (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
/**
* @file me_slist.h
*
* @brief Provides the subdevice list class.
* @note Copyright (C) 2007 Meilhaus Electronic GmbH (support@meilhaus.de)
* @author Guenter Gebhardt
*/
#ifndef _ME_SLIST_H_
#define _ME_SLIST_H_
#include <linux/list.h>
#include "mesubdevice.h"
#ifdef __KERNEL__
/**
* @brief The subdevice list container.
*/
typedef struct me_slist {
struct list_head head; /**< The head of the internal list. */
unsigned int n; /**< The number of subdevices in the list. */
} me_slist_t;
/**
* @brief Queries the number of subdevices currently inside the list.
*
* @param slist The subdevice list to query.
* @param[out] number The number of subdevices of the device.
*
* @return ME-iDS error code.
*/
int me_slist_query_number_subdevices(struct me_slist *slist, int *number);
/**
* @brief Returns the number of subdevices currently inside the list.
*
* @param slist The subdevice list to query.
*
* @return The number of subdevices in the list.
*/
unsigned int me_slist_get_number_subdevices(struct me_slist *slist);
/**
* @brief Get a subdevice by index.
*
* @param slist The subdevice list to query.
* @param index The index of the subdevice to get in the list.
*
* @return The subdevice at index if available.\n
* NULL if the index is out of range.
*/
me_subdevice_t *me_slist_get_subdevice(struct me_slist *slist,
unsigned int index);
/**
* @brief Get a subdevice index by type and subtype.
*
* @param slist The subdevice list to query.
* @param start_subdevice The subdevice index at which the start shall begin.
* @param type The type of the subdevice to query.
* @param subtype The subtype of the subdevice to query.
* @param[out] subdevice On success this parameter returns the index of the subdevice matching the requested type.
*
* @return ME_ERRNO_SUCCESS on success.
*/
int me_slist_get_subdevice_by_type(struct me_slist *slist,
unsigned int start_subdevice,
int type, int subtype, int *subdevice);
/**
* @brief Adds a subdevice to the tail of the list.
*
* @param slist The subdevice list to add a subdevice to.
* @param subdevice The subdevice to add to the list.
*/
void me_slist_add_subdevice_tail(struct me_slist *slist,
me_subdevice_t * subdevice);
/**
* @brief Removes a subdevice from the tail of the list.
*
* @param slist The subdevice list.
*
* @return Pointer to the removed subdeivce.\n
* NULL in cases where the list was empty.
*/
me_subdevice_t *me_slist_del_subdevice_tail(struct me_slist *slist);
/**
* @brief Initializes a subdevice list structure.
*
* @param lock The subdevice list structure to initialize.
* @return 0 on success.
*/
int me_slist_init(me_slist_t * slist);
/**
* @brief Deinitializes a subdevice list structure and destructs every subdevice in it.
*
* @param slist The subdevice list structure to deinitialize.
* @return 0 on success.
*/
void me_slist_deinit(me_slist_t * slist);
#endif
#endif
|