HRESULT DataSet(PVOID pBuffer, DWORD dwSize);
Writes digital-audio data to the end of the object's internal buffer.
· Returns NOERROR if successful, or one of these error values:
E_INVALIDARG
E_OUTOFMEMORY
AUDERR_NEEDWAVEFORMAT
AUDERR_NOTCLAIMED
AUDERR_NOTENOUGHDATA
pBuffer
[in] Address of a buffer that contains the data to be copied into the object's internal buffer.
dwSize
[in] Number of bytes of data to copy.
An audio-destination object contains an internal first-in/first-out (FIFO) buffer of digital-audio data. As audio is sent to the audio destination, it is taken from the beginning of the buffer. Each time DataSet is called, the new information is added to the end of the buffer. If the amount of data requested is too large to fit the buffer, DataSet returns an error.
An engine must call the IAudio::Claim member function before calling DataSet. When all buffers have been sent to the audio destination, the engine must call the IAudio::UnClaim member function.