National Instruments 320682C Musical Toy Instrument User Manual


 
DDE Library Chapter 6
LabWindows/CVI Standard Libraries 6-8 © National Instruments Corporation
If successful, this function returns the number of bytes sent. Otherwise, this function returns a
negative error code. See the help for the status control for the error code values.
Note: Your program should not call AdviseDDEDataReady in a tight loop because the
iterations will compete with user interface events for the CPU time. You should use
this function sparingly, and only when the value of the hot- or warm-linked data object
changes. In cases when large data objects are to be returned from the server, your
program should only call AdviseDDEDataReady when the user interface is not
busy.
See Also
RegisterDDEServer, SetUpDDEHotLink, SetUpDDEWarmLink,
BroadcastDDEDataReady
BroadcastDDEDataReady
int status = BroadcastDDEDataReady (char serverName[], char itemName[],
char topicName[], unsigned int dataFormat,
void *dataPointer, unsigned int dataSize)
Purpose
Called by a server to send, to send data to all clients that have set up hot or warm links on the
specified topic and item.
Parameters
Input
serverName
string Identifies the server from which to send the data.
topicName
string Identifies the topic with which the data is
associated.
itemName
string Identifies the item with which the data is
associated.
dataFormat
unsigned
integer
Valid data format; for example, CF_TEXT.
dataPointer
void pointer Pointer to buffer holding data.
dataSize
unsigned
integer
Number of bytes in data. Limited to 64 KB on
Windows 3.1 and Windows 95.
Return Value
status
integer Refer to error codes in Table 6-3.