Method

HinawaSndEfwtransaction_sync

deprecated: 2.5. since: 2.1.

Declaration [src]

void
hinawa_snd_efw_transaction_sync (
  HinawaSndEfw* self,
  guint category,
  guint command,
  const guint32* args,
  gsize arg_count,
  guint32* const* params,
  gsize* param_count,
  guint timeout_ms,
  GError** error
)

Description [src]

Transfer asynchronous transaction for command frame of Echo Fireworks protocol, then wait asynchronous transaction for response frame within the given timeout.

Available since: 2.1.

Deprecated since: 2.5.

Use implementation of Hitaki.EfwProtocol.transaction in Hitaki.SndEfw instead.

Parameters

category

Type: guint

One of category for the transaction.

command

Type: guint

One of commands for the transaction.

args

Type: An array of guint32

An array with elements for quadlet data as arguments for command.

The argument can be NULL.
The length of the array is specified in the arg_count argument.
The data is owned by the caller of the function.
arg_count

Type: gsize

The number of quadlets in the args array.

params

Type: An array of guint32*

An array with elements for quadlet data to save parameters in response. Callers should give it for buffer with enough space against the request since this library performs no reallocation. Due to the reason, the value of this argument should point to the pointer to the array and immutable. The content of array is mutable for parameters in response.

The argument will be modified by the function.
The argument can be set to NULL by the method.
The length of the array is specified in the param_count argument.
The instance takes ownership of the data, and is responsible for freeing it.
param_count

Type: gsize*

The number of quadlets in the params array.

The argument will be modified by the function.
timeout_ms

Type: guint

The timeout to wait for response of the transaction since request is transferred in milliseconds.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.