Q3Controller_GetValues
You can use theQ3Controller_GetValues
function to get the list of values of a controller.
TQ3Status Q3Controller_GetValues ( TQ3ControllerRef controllerRef, unsigned long valueCount, float *values, TQ3Boolean *changed, unsigned long *serialNumber);
controllerRef
- A reference to a controller.
valueCount
- The number of elements in the array pointed to by the
values
parameter.values
- On entry, a pointer to an array of controller values. The size of the array is determined by the number of elements in the array (as specified by the
valueCount
parameter) and the size of a controller value (which is controller-dependent).changed
- On exit, a Boolean value that indicates whether the specified array of values was changed (
kQ3True
) or not (kQ3False
).serialNumber
- On entry, a controller serial number, or
NULL
.DESCRIPTION
TheQ3Controller_GetValues
function returns, in thevalues
parameter, a pointer to an array that contains the current values for the controller specified in thecontrollerRef
parameter. ThevalueCount
parameter specifies the number of elements in the array (which you must already have allocated).Q3Controller_GetValues
might fill in fewer elements if the controller does not support the specified number of values.If the value of the
serialNumber
parameter isNULL
,Q3Controller_GetValues
fills in thevalues
array and returns the valuekQ3True
in thechanged
parameter. Otherwise, the value specified in theserialNumber
parameter is compared with the controller's current serial number. If the two serial numbers are identical,Q3Controller_GetValues
leaves thevalues
array and theserialNumber
parameter unchanged and returns the valuekQ3False
in thechanged
parameter. If the two serial number differ,Q3Controller_GetValues
fills in thevalues
array, updates theserialNumber
parameter, and returns the valuekQ3True
in thechanged
parameter.If the specified controller is inactive, the
values
array and thechanged
parameter are unchanged.
Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help