National Instruments 320682C Musical Toy Instrument User Manual


 
X Property Library Chapter 9
LabWindows/CVI Standard Libraries 9-26 © National Instruments Corporation
Parameters (Continued)
numberofProperties
unsigned integer Number of properties in the
Property List.
callbackData
generic pointer Pointer to data to be passed to
the callback function. This
value is passed to the callback
function as the userData
parameter.
callbackFunction
PropertyCallbackTypeX
*
Pointer to the function to be
called when the properties
change.
Return Values
The return value indicates the success or failure status of the function call. A negative value
indicates an error. The following table shows status values.
Table 9-4. Status Values for InstallXPropertyCallback
NoXErr
0 The function was successful.
InvalidParamXErr
-1 NULL was passed to one or more parameters. The
number of windows argument is 0.
InvalidDisplayXErr
-2
The display argument is not a valid display. This
argument must either be the predefined value
CVIXDisplay
or be the value returned by
ConnectToXDisplay
.
InvalidWindowXErr
-3
One or more of the windows in the windowList argument
are not valid.
InvalidPropertyXErr
-4
One or more of the property handles in the propertyList
argument are not valid. These properties must be values
returned by
CreateXProperty
.
InsuffMemXErr
-19 There is insufficient memory to perform the operation.
BrokenConnectionXErr
-21 The connection to the X server was broken. This occurs if
the remote server terminated.
Parameter Discussion
display must either be the predefined value
CVIXDisplay
or be the value returned by
ConnectToXDisplay
. Use
CVIXDisplay
if the window is on the same display used by
LabWindows/CVI.
To specify a single window, named
win
, pass the expression
&
win
for the windowList
parameter and pass
1
for the numberOfWindows. Use
&CVIXRootWindow
to access the