GCLIB_DLL_EXPORTED GReturn GCALL GUtility | ( | GCon | g, |
GOption | request, | ||
GMemory | memory1, | ||
GMemory | memory2 | ||
) |
Provides read/write access to driver settings and convenience features based on the request variable.
g | Connection's handle. |
request | Defines the request. Input/Output and type of memory are implicit in the value of request. The following lists the supported request values. |
--timeout
switch.memory1
is output and must be a pointer to an unsigned short.memory2
is ignored, use null.memory1
is input. If nonnull, value must be a pointer to a short which overrides the timeout. Write G_USE_INITIAL_TIMEOUT
to use initial timeout. If null, no write occurs.memory2
is output. If nonnul, value must be a pointer to a short which will be filled with the current override. G_USE_INITIAL_TIMEOUT
indicates initial timeout used. If null, no read occurs. memory2
is processed before 'memory1`.memory1
is output, and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.memory1
is input and must be a pointer to an unsigned int, units are milliseconds.memory2
is ignored, use null.-d
will be appended to each address to indicate these addresses are available via direct connection. See G_UTIL_GCAPS_ADDRESSES
for addresses through gcaps.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.G_GCLIB_UTILITY_IP_TAKEN
will be returned by GUtility() if the ping returns a response.memory1
is input and must be a pointer to a GCStringIn
containing the address that is to be assigned. e.g. "192.168.0.43"
.memory2
is input and must be a pointer to a GCStringIn
containing the controller's MAC address. e.g. "00:50:4C:20:01:23"
.memory1
is ignored, use null.memory2
is ignored, use null.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.G_UTIL_GCAPS_KEEPALIVE
within the timeout period to reset the timer. The current interval can be optionally read and overwritten.memory1
is output. If nonnull, value must be a pointer to a GSIZE
which will be filled with the current gcaps timeout, in ms.memory2
is input. If nonnull, value must be a pointer to a GSIZE
which overrides the current gcaps timeout, in ms, for this connection.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.memory1
is output and must be a GCStringOut
. Data will be null terminated, even if the data must be truncated to do so.memory2
is input and must be a pointer to a GSize
holding the length of the buffer in memory1
.memory1
is input and must be a pointer to a GCStringIn
containing the address that is to be assigned. e.g. "192.168.0.43"
.memory2
is input and must be a pointer to a GCStringIn
containing the controller's MAC address. e.g. "00:50:4C:20:01:23"
.memory1 | An untyped pointer to data type required for request. |
memory2 | An untyped pointer to data type required for request. |
See the following functions from gclibo, the open source portion, for examples:
Referenced by GAddresses(), GAssign(), GInfo(), GIpRequests(), GSleep(), GTimeout(), and GVersion().