alsaseq 0.8.0

API binding for alsaseq library
Documentation 
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

// SPDX-License-Identifier: MIT
use super::*;

/// Get the list of subscription for given address and query type.
///
/// The call of function executes `open(2)`, `close(2)`, and `ioctl(2)` system calls with
/// `SNDRV_SEQ_IOCTL_QUERY_SUBS` command for ALSA sequencer character device.
/// ## `addr`
/// A [`Addr`][crate::Addr] to query.
/// ## `query_type`
/// The type of query, one of [`QuerySubscribeType`][crate::QuerySubscribeType].
///
/// # Returns
///
/// [`true`] when the overall operation finishes successfully, else [`false`].
///
/// ## `entries`
/// The array with element for subscription
///           data.
#[doc(alias = "alsaseq_get_subscription_list")]
#[doc(alias = "get_subscription_list")]
pub fn subscription_list(
    addr: &Addr,
    query_type: QuerySubscribeType,
) -> Result<Vec<SubscribeData>, glib::Error> {
    unsafe {
        let mut entries = std::ptr::null_mut();
        let mut error = std::ptr::null_mut();

        ffi::alsaseq_get_subscription_list(
            addr.to_glib_none().0,
            query_type.into_glib(),
            &mut entries,
            &mut error,
        );

        if error.is_null() {
            Ok(FromGlibPtrContainer::from_glib_full(entries))
        } else {
            Err(from_glib_full(error))
        }
    }
}

/// Get current status of queue.
///
/// The call of function executes `open(2)`, `close(2)`, and `ioctl(2)` system calls with
/// `SNDRV_SEQ_IOCTL_GET_QUEUE_STATUS` command for ALSA sequencer character device.
/// ## `queue_id`
/// The numeric ID of queue. One of [`SpecificQueueId`][crate::SpecificQueueId] is available as well.
/// ## `queue_status`
/// The current status of queue.
///
/// # Returns
///
/// [`true`] when the overall operation finishes successfully, else [`false`].
#[doc(alias = "alsaseq_get_queue_status")]
#[doc(alias = "get_queue_status")]
pub fn queue_status<P: IsA<QueueStatus>>(
    queue_id: u8,
    queue_status: &mut P,
) -> Result<(), glib::Error> {
    unsafe {
        let mut error = std::ptr::null_mut();

        ffi::alsaseq_get_queue_status(
            queue_id,
            &mut queue_status.as_ref().to_glib_none().0,
            &mut error,
        );

        if error.is_null() {
            Ok(())
        } else {
            Err(from_glib_full(error))
        }
    }
}