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_GetSignature

You can use the Q3Controller_GetSignature function to get the signature of a controller.

TQ3Status Q3Controller_GetSignature (
TQ3ControllerRef controllerRef, 
char *signature, 
unsigned long numChars);

controllerRef

A reference to a controller.

signature

On entry, a pointer to a buffer that is to be filled with the signature of the specified controller.

numChars

On entry, the size of the buffer pointed to by the signature parameter.

DESCRIPTION

The Q3Controller_GetSignature function returns, through the signature parameter, the signature of the controller specified by the controllerRef parameter. You are responsible for allocating a buffer whose address is passed in the signature parameter and whose size is passed in the numChars parameter. If the signature is larger than the specified size, the signature is truncated to fit in the buffer.