Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference

QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Controllers

Q3Controller_GetChannel

You can use the Q3Controller_GetChannel function to get a controller channel.

TQ3Status Q3Controller_GetChannel (
TQ3ControllerRef controllerRef, 
unsigned long channel, 
void *data, 
unsigned long *dataSize);

controllerRef

A reference to a controller.

channel

An index into the list of channels associated with the specified controller. This value is always greater than or equal to 0 and less than the channel count specified at the time Q3Controller_New was called.

data

On exit, a pointer to the current value of the specified controller channel. The data type of the returned channel is controller-specific.

dataSize

On entry, the number of bytes in the specified buffer. On exit, the number of bytes actually written to that buffer.

DESCRIPTION

The Q3Controller_GetChannel function returns, through the data parameter, the current controller channel specified by the controllerRef and channel parameters. You are responsible for allocating memory for the data buffer and passing the size of that buffer in the dataSize parameter. Q3Controller_GetChannel returns, in the dataSize parameter, the number of bytes written to the data buffer.