boolean StoreTone(BSTR pszFileName)
Function StoreTone(pszFileName As String) As Boolean
Sends the local Tone array to a file in the WS Client.
Return value
True=successful, False=error, unable to create the file,
RF link lost, check by RFGetLastError().
Parameters
pszFileName
The name of the tone file (up to 8 characters).
Remarks
You need to build a Tone in the application.
The built Tone is sent to the terminal that stores it in a file.
The Client program reads this file to perform the beeps.
The name must contain legal characters for MS-DOS filenames. Do not
include dots (.) and other special characters (* , $ \ : etc).
The tone "ERROR" is played by RFERROR.Display()
method.
Example
Public wsRfTone As New RFTONE
Public Sub Main()
' Storing an "error" tone
wsRfTone.ClearTones ' Clear the current tone
wsRfTone.AddTone 2800, 500 ' add tone frequency and duration
wsRfTone.AddTone 1400, 500
wsRfTone.AddTone 2800, 500
wsRfTone.AddTone 1400, 500
' Warning, give a valid DOS file Name (8.3) W/O extension
wsRfTone.StoreTone "DemoTone" ' Store tone as a file
End Sub
See also RFTONE, PlayTone, DeleteToneFile, RFERROR, Display