You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
253 lines
10 KiB
253 lines
10 KiB
// dswave.h
|
|
// (c) 1999-2000 Microsoft Corp.
|
|
|
|
#ifndef _DSWAVE_H_
|
|
#define _DSWAVE_H_
|
|
|
|
#include <mmsystem.h>
|
|
#include <mmreg.h>
|
|
#include <msacm.h>
|
|
#include "dsoundp.h" // For IDirectSoundWave and IDirectSoundSource
|
|
#include "dmusicc.h"
|
|
#include "dmusici.h"
|
|
#include "riff.h"
|
|
|
|
extern long g_cComponent;
|
|
|
|
#define REF_PER_MIL 10000 // For converting from reference time to mils
|
|
#define CONVERTLENGTH 250
|
|
|
|
// #define DSWCS_F_DEINTERLEAVED 0x00000001 // Multi-channel data as multiple buffers
|
|
// FIXME: unimplemented so far?
|
|
|
|
typedef struct tCREATEVIEWPORT
|
|
{
|
|
IStream *pStream;
|
|
DWORD cSamples;
|
|
DWORD dwDecompressedStart;
|
|
DWORD cbStream;
|
|
LPWAVEFORMATEX pwfxSource;
|
|
LPWAVEFORMATEX pwfxTarget;
|
|
DWORD fdwOptions;
|
|
} CREATEVIEWPORT, *PCREATEVIEWPORT;
|
|
|
|
|
|
// Private interface for getting the length of a wave
|
|
interface IPrivateWave : IUnknown
|
|
{
|
|
virtual HRESULT STDMETHODCALLTYPE GetLength(REFERENCE_TIME *prtLength)=0;
|
|
};
|
|
|
|
DEFINE_GUID(IID_IPrivateWave, 0xce6ae366, 0x9d61, 0x420a, 0xad, 0x53, 0xe5, 0xe5, 0xf6, 0xa8, 0x4a, 0xe4);
|
|
|
|
// Flags for SetWaveBehavior()
|
|
|
|
#define DSOUND_WAVEF_ONESHOT 1 /* The wave will be played as a one shot */
|
|
#define DSOUND_WAVEF_PORT 2 /* The wave will be played via a DMusic port. */
|
|
#define DSOUND_WAVEF_SINK 4 /* The wave will be played via a streamed sink interface. */
|
|
#define DSOUND_WAVEF_CREATEMASK 0x00000001 /* Currently only ONESHOT is define for CreateSource */
|
|
|
|
#define DSOUND_WVP_NOCONVERT 0x80000000 /* The viewport data is the same format as the wave */
|
|
#define DSOUND_WVP_STREAMEND 0x40000000 /* The viewport data is the same format as the wave */
|
|
#define DSOUND_WVP_CONVERTSTATE_01 0x01000000
|
|
#define DSOUND_WVP_CONVERTSTATE_02 0x02000000
|
|
#define DSOUND_WVP_CONVERTSTATE_03 0x04000000
|
|
|
|
#define DSOUND_WVP_CONVERTMASK 0x0f000000
|
|
|
|
/* The CWaveViewPort structure represents one instance, or "view", of the
|
|
wave object. It manages the reading of the wave data, ACM decompression,
|
|
and demultiplexing into mono buffers. If a wave object is being
|
|
streamed, each playback instance gets a unique CWaveViewPort.
|
|
However, in the more typical case where the wave object is being
|
|
played as a one shot, each playback instance uses the same
|
|
CWaveViewPort.
|
|
Each additional CWaveViewPort owns a cloned instance of the IStream.
|
|
*/
|
|
|
|
class CWaveViewPort :
|
|
public IDirectSoundSource // Used by a port or sink to pull data.
|
|
{
|
|
public:
|
|
CWaveViewPort(); // Constructor receives stream.
|
|
~CWaveViewPort(); // Destructor releases memory, streams, etc.
|
|
|
|
// IUnknown
|
|
STDMETHODIMP QueryInterface(const IID &iid, void **ppv);
|
|
STDMETHODIMP_(ULONG) AddRef();
|
|
STDMETHODIMP_(ULONG) Release();
|
|
|
|
// IDirectSoundSource
|
|
STDMETHODIMP SetSink(IDirectSoundConnect *pSinkConnect);
|
|
STDMETHODIMP GetFormat(LPWAVEFORMATEX pwfx, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten);
|
|
STDMETHODIMP Seek(ULONGLONG sp);
|
|
STDMETHODIMP Read(LPVOID *ppvBuffer, LPDWORD pdwBusIds, LPDWORD pdwFuncIds, LPLONG plPitchShifts, DWORD cpvBuffer, ULONGLONG *pcb);
|
|
STDMETHODIMP GetSize(ULONGLONG *pcb);
|
|
|
|
// Misc
|
|
HRESULT Create(PCREATEVIEWPORT pCreate);
|
|
|
|
private:
|
|
|
|
HRESULT acmRead();
|
|
|
|
// General stuff...
|
|
CRITICAL_SECTION m_CriticalSection; // Used to ensure thread safe
|
|
long m_cRef; // COM reference counter.
|
|
|
|
// Details about original data stream...
|
|
IStream * m_pStream; // IStream pointer which is connected to IPersistStream
|
|
// interface to pull data from file.
|
|
DWORD m_cSamples; // Number of samples (if available)
|
|
DWORD m_cbStream; // Number of bytes in stream.
|
|
DWORD m_dwStart; // Offset into stream where data starts
|
|
//LPWAVEFORMATEX m_pwfxSource; // Do we need to hold on to this?
|
|
|
|
// Details needed for this viewport.
|
|
DWORD m_dwOffset; // Current byte offset into data stream
|
|
DWORD m_dwStartPos; // Initial Start Offset
|
|
LPWAVEFORMATEX m_pwfxTarget; // Target destination format.
|
|
ACMSTREAMHEADER m_ash; // ACM Stream header (used for conversion)
|
|
HACMSTREAM m_hStream; // ACM Stream handle for conversion
|
|
LPBYTE m_pDst; // Pointer to (decompressed) destination
|
|
LPBYTE m_pRaw; // Pointer to compressed source buffer
|
|
DWORD m_fdwOptions; // Options for viewport
|
|
|
|
DWORD m_dwDecompressedStart; // Actual start for the data after decompression in Samples
|
|
// This is important for MP3 and WMA codecs that
|
|
// insert some amount of silence in the beginning
|
|
|
|
DWORD m_dwDecompStartOffset; // Byte Offset in the compressed stream to the block which
|
|
// needs to be decompressed to get to the right start value
|
|
|
|
DWORD m_dwDecompStartOffsetPCM;// Byte offset in the decompressed stream...corresponds to
|
|
// m_dwDecompressedStart samples
|
|
|
|
DWORD m_dwDecompStartDelta; // The delta (in bytes) to add when we decompress the block starting
|
|
// from m_dwDecompStartOffset
|
|
|
|
// Only used to accurately get data after precached data for DirectSoundWave in DMusic
|
|
DWORD m_dwPreCacheFilePos;
|
|
DWORD m_dwFirstPCMSample;
|
|
DWORD m_dwPCMSampleOut;
|
|
};
|
|
|
|
/* The CWave class represents one instance of a wave object. It
|
|
supports the IDirectSoundWave interface, which the application
|
|
uses to access the wave. It also support IPersistStream and
|
|
IDirectMusicObject, which are used by the loader to load the
|
|
wave data from a stream into the wave object.
|
|
And, the IDirectSoundSource interface manages the direct
|
|
transfer of the wave data from the object to the
|
|
synth or DirectSound. This is for internal use, not by the
|
|
application (though it represents an easy way for an app
|
|
to load wave data and then extract it.)
|
|
CWave maintains a list of CWaveViewPorts, though typically
|
|
there is only one.
|
|
*/
|
|
|
|
class CWave :
|
|
public IDirectSoundWave, // Standard interface.
|
|
public IPersistStream, // For file io
|
|
public IDirectMusicObject, // For DirectMusic loader
|
|
public IPrivateWave // For GetLength
|
|
{
|
|
public:
|
|
CWave();
|
|
~CWave();
|
|
|
|
// IUnknown
|
|
STDMETHODIMP QueryInterface(const IID &iid, void **ppv);
|
|
STDMETHODIMP_(ULONG) AddRef();
|
|
STDMETHODIMP_(ULONG) Release();
|
|
|
|
// IDirectSoundWave
|
|
STDMETHODIMP GetFormat(LPWAVEFORMATEX pWaveFormatEx, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten);
|
|
STDMETHODIMP CreateSource(IDirectSoundSource **ppSource, LPWAVEFORMATEX pwfx, DWORD dwFlags);
|
|
STDMETHODIMP GetStreamingParms(LPDWORD pdwFlags, LPREFERENCE_TIME prtReadahread);
|
|
|
|
// IPersist functions (base class for IPersistStream)
|
|
STDMETHODIMP GetClassID( CLSID* pClsId );
|
|
|
|
// IPersistStream functions
|
|
STDMETHODIMP IsDirty();
|
|
STDMETHODIMP Load( IStream* pIStream );
|
|
STDMETHODIMP Save( IStream* pIStream, BOOL fClearDirty );
|
|
STDMETHODIMP GetSizeMax( ULARGE_INTEGER FAR* pcbSize );
|
|
|
|
// IDirectMusicObject
|
|
STDMETHODIMP GetDescriptor(LPDMUS_OBJECTDESC pDesc);
|
|
STDMETHODIMP SetDescriptor(LPDMUS_OBJECTDESC pDesc);
|
|
STDMETHODIMP ParseDescriptor(LPSTREAM pStream, LPDMUS_OBJECTDESC pDesc);
|
|
|
|
// IPrivateWave
|
|
STDMETHODIMP GetLength(REFERENCE_TIME *prtLength);
|
|
|
|
private:
|
|
|
|
// Internal methods.
|
|
|
|
BOOL ParseHeader(IStream *pIStream, IRIFFStream* pIRiffStream, LPMMCKINFO pckMain);
|
|
|
|
void FallbackStreamingBehavior()
|
|
{
|
|
REFERENCE_TIME rtLength = 0;
|
|
if (SUCCEEDED(GetLength(&rtLength)))
|
|
{
|
|
// if > 5000 milliseconds, set to streaming with a 500 ms readahead
|
|
if (rtLength > 5000)
|
|
{
|
|
m_rtReadAheadTime = 500 * REF_PER_MIL;
|
|
m_fdwFlags &= ~DSOUND_WAVEF_ONESHOT;
|
|
}
|
|
else
|
|
{
|
|
m_rtReadAheadTime = 0;
|
|
m_fdwFlags |= DSOUND_WAVEF_ONESHOT;
|
|
}
|
|
}
|
|
}
|
|
|
|
CRITICAL_SECTION m_CriticalSection; // Used to ensure thread safe
|
|
LPWAVEFORMATEX m_pwfxDst; // Destination format, if compressed
|
|
REFERENCE_TIME m_rtReadAheadTime; // Readahead for streaming.
|
|
DWORD m_fdwFlags; // Various flags, including whether this is a one-shot.
|
|
long m_cRef; // COM reference counter.
|
|
IStream * m_pStream; // IStream pointer which is connected to IPersistStream
|
|
DWORD m_fdwOptions; // Flags set by call to SetWaveBehavior().
|
|
LPWAVEFORMATEX m_pwfx; // File's format
|
|
DWORD m_cbStream;
|
|
DWORD m_cSamples;
|
|
GUID m_guid;
|
|
FILETIME m_ftDate;
|
|
DMUS_VERSION m_vVersion;
|
|
WCHAR m_wszFilename[DMUS_MAX_FILENAME];
|
|
DWORD m_dwDecompressedStart;
|
|
};
|
|
|
|
class CDirectSoundWaveFactory : public IClassFactory
|
|
{
|
|
public:
|
|
// IUnknown
|
|
//
|
|
virtual STDMETHODIMP QueryInterface(const IID &iid, void **ppv);
|
|
virtual STDMETHODIMP_(ULONG) AddRef();
|
|
virtual STDMETHODIMP_(ULONG) Release();
|
|
|
|
// Interface IClassFactory
|
|
//
|
|
virtual STDMETHODIMP CreateInstance(IUnknown* pUnknownOuter, const IID& iid, void** ppv);
|
|
virtual STDMETHODIMP LockServer(BOOL bLock);
|
|
|
|
// Constructor
|
|
//
|
|
CDirectSoundWaveFactory();
|
|
|
|
// Destructor
|
|
~CDirectSoundWaveFactory();
|
|
|
|
private:
|
|
long m_cRef;
|
|
};
|
|
|
|
#endif // _DSWAVE_H_
|