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 aNULL
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.