HinawaSndDice: Hinawa Reference Manual

HinawaSndDice

HinawaSndDice — A notification listener for Dice models

Functions

HinawaSndDice *	hinawa_snd_dice_new ()
void	hinawa_snd_dice_open ()
void	hinawa_snd_dice_transaction ()
void	hinawa_snd_dice_transact ()

Signals

void

notified

Run Last

Object Hierarchy

    GObject
    ╰── HinawaFwUnit
        ╰── HinawaSndUnit
            ╰── HinawaSndDice

Description

A HinawaSndDice listen to Dice notification and generates signal when received. This inherits HinawaSndUnit.

Functions

hinawa_snd_dice_new ()

HinawaSndDice *
hinawa_snd_dice_new (void);

Instantiate HinawaSndDice object and return the instance.

Returns

an instance of HinawaSndDice.

Since: 1.3.

hinawa_snd_dice_open ()

void
hinawa_snd_dice_open (HinawaSndDice *self,
                      gchar *path,
                      GError **exception);

Open ALSA hwdep character device and check it for Dice devices.

Parameters

self	A HinawaSndUnit
path	A full path of a special file for ALSA hwdep character device
exception	A GError

hinawa_snd_dice_transaction ()

void
hinawa_snd_dice_transaction (HinawaSndDice *self,
                             guint64 addr,
                             const guint32 *frame,
                             gsize frame_count,
                             guint32 bit_flag,
                             GError **exception);

Execute write transactions to the given address, then wait and check notification.

Parameters

self	A HinawaSndDice
addr	A destination address of target device
frame	An array with elements for quadlet data to transmit.	[array length=frame_count][in]
frame_count	The number of quadlets in the frame.
bit_flag	bit flag to wait
exception	A GError

Since: 1.4.

hinawa_snd_dice_transact ()

void
hinawa_snd_dice_transact (HinawaSndDice *self,
                          guint64 addr,
                          GArray *frame,
                          guint32 bit_flag,
                          GError **exception);

hinawa_snd_dice_transact has been deprecated since version 1.4 and should not be used in newly-written code.

Use hinawa_snd_dice_transaction(), instead.

Execute write transactions to the given address, then wait and check notification.

Parameters

self	A HinawaSndDice
addr	A destination address of target device
frame	a 32bit array.	[element-type guint32][array][in]
bit_flag	bit flag to wait
exception	A GError

Signal Details

The `“notified”` signal

void
user_function (HinawaSndDice *self,
               gulong         message,
               gpointer       user_data)

When Dice models transfer notification, the ::notified signal is generated.

Parameters

self	A HinawaSndDice
message	A notification message
user_data	user data set when the signal handler was connected.

Flags: Run Last

HinawaSndDice

Functions

Signals

Object Hierarchy

Description

Functions

hinawa_snd_dice_new ()

Returns

hinawa_snd_dice_open ()

Parameters

hinawa_snd_dice_transaction ()

Parameters

hinawa_snd_dice_transact ()

Parameters

Signal Details

The “notified” signal

Parameters

The `“notified”` signal