Sound Function - Sound Module Control Function

sdPstmIsTransferWaveData

Checks if okay to transfer a waveform to a PCM Stream port

FORMAT

SDE_ERR sdPstmIsTransferWaveData( handle, ch_num, data_size, *flg )
SDPSTM handle
Sint8 ch_num
Sint32 data_size
Bool *flg

PARAMETER

 handle  Object handle 
 ch_num  Object channel 
 data_size  Size of waveform desired to transfer, in bytes 
 flg  Pointer to storage for test result 

RETURN

 SDE_ERR_NO_INIT  The Sound Library has not been initialized 
 SDE_ERR_HANDLE_NULL  The handle is NULL 
 SDE_ERR_PRM_OVER_RANGE  Parameter out of range 

DESCRIPTION

Checks if okay to transfer a waveform to a PCM Stream port.

Units of data_size which specifies waveform size are bytes.

Pointer to storage for test result: true if transfer possible, or false if not


NOTE

The waveform cannot be transferred until flg is returned true.

If PCM Stream play has not been started, a size larger than 7000H cannot be specified. Even if this API function is called several times, if PCM Stream play has not been started, the ring buffer is not refreshed, but overwritten instead (that is, the refresh position does not advance from the ring buffer head address).


sdPstmIsTransferWaveData
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998,1999