Class DirectSoundResource
public class DirectSoundResource implements
IDirectSoundResource
{
// Methods
public void loadWaveFile(String name,
DSResourceDesc resourceDesc, byte[] wave);
public WaveFormatEx loadWaveFile(String name,
DSResourceDesc resourceDesc);
public void loadWaveResource(int handle,
DSResourceDesc resourceDesc, byte[] wave);
public WaveFormatEx loadWaveResource(int handle,
DSResourceDesc resourceDesc);
public void readBuffer(int sourceIndex, int destIndex, int size,
DSResourceDesc resourceDesc, byte[] buffer, int maxbuf);
}
Applications use the DirectSoundResource class to load wave format objects.
public void loadWaveFile(String name, DSResourceDesc resourceDesc,
byte[] wave);
Loads a wave resource from the given file.
Return Value:
No return value.
Parameter | Description |
name
| Name of the file that contains the resource.
|
resourceDesc
| The DSResourceDesc object that receives a description of the resource.
|
wave
| Array variable that receives the wave resource data.
|
public WaveFormatEx loadWaveFile(String name, DSResourceDesc resourceDesc);
Loads a wave resource from a file and returns it as a wave format object.
Return Value:
Returns the WaveFormatEx object if successful; null otherwise.
Parameter | Description |
name
| Name of the file that contains the resource.
|
resourceDesc
| The DSResourceDesc object that receives a description of the resource.
|
public void loadWaveResource(int handle, DSResourceDesc resourceDesc,
byte[] wave);
Loads a wave resource from the given module.
Return Value:
No return value.
Parameter | Description |
handle
| Handle of the module containing the resource.
|
resourceDesc
| The DSResourceDesc object that receives a description of the resource.
|
wave
| Array variable that receives the wave resource data.
|
public WaveFormatEx loadWaveResource(int handle,
DSResourceDesc resourceDesc);
Loads a wave resource and returns it as a wave format object.
Return Value:
Returns the WaveFormatEx object if successful; null otherwise.
Parameter | Description |
handle
| Handle of the module containing the resource.
|
resourceDesc
| The DSResourceDesc object that receives a description of the resource.
|
public void readBuffer(int sourceIndex, int destIndex, int size,
DSResourceDesc resourceDesc, byte[] buffer, int maxbuf);
Reads an amount of data from a resource into the given buffer.
Return Value:
No return value.
Parameter | Description |
sourceIndex
| Index into the resource, indicating the first byte of data to read.
|
destIndex
| Index into the buffer, indicating to first byte to receive the data to be read.
|
size
| Number of bytes of data to read.
|
resourceDesc
| The DSResourceDesc object that contains a description of the resource. The fields of this object must have been previously initialized by using loadWaveResource or loadWaveFile.
|
buffer
| Array variable that receives the data.
|
maxbuf
| Length of the buffer array. The method retrieves no more than this amount of data.
|
Remarks:
If destIndex is non-zero and destIndex + size is greater than maxbuf, the method fills to the end of the buffer, then wraps back to the beginning of the buffer and continues to fill the buffer until the method reads the requested data or encounters the position specified by destIndex.