| Microsoft DirectX 8.1 (C++) |
The DMUS_AUDIOPARAMS structure describes required resources for the default synthesizer and buffers of a performance. Passed to the IDirectMusicPerformance8::InitAudio method to request desired features and to receive information about what requests were granted.
Syntax
typedef struct _DMUS_AUDIOPARAMS {
DWORD dwSize;
BOOL fInitNow;
DWORD dwValidData;
DWORD dwFeatures;
DWORD dwVoices;
DWORD dwSampleRate;
CLSID clsidDefaultSynth;
} DMUS_AUDIOPARAMS;
Members
dwSize
Size of the structure, in bytes. This member must be initialized before the structure is used.
fInitNow
Boolean value that specifies whether the sink and synthesizer are created immediately. If so, results are returned in this structure.
dwValidData
Flags that specify which members of this structure are valid. If fInitNow is TRUE when the structure is passed, this member receives flags that specify what members received data. The following values are defined.
| Flag | Description |
| DMUS_AUDIOPARAMS_FEATURES | The dwFeatures member contains or has received data. |
| DMUS_AUDIOPARAMS_VOICES | The dwVoices member contains or has received data. |
| DMUS_AUDIOPARAMS_SAMPLERATE | The dwSampleRate member contains or has received data. |
| DMUS_AUDIOPARAMS_DEFAULTSYNTH | The clsidDefaultSynth member contains or has received data. If this flag is not set, the Microsoft software synthesizer is the default synthesizer. |
dwFeatures
Flags that specify required capabilities. The following values are defined.
| Flag | Description |
| DMUS_AUDIOF_3D | 3-D buffers. |
| DMUS_AUDIOF_ALL | Combination of all other flags. |
| DMUS_AUDIOF_BUFFERS | Multiple buffers. Always set this flag when using audiopaths. |
| DMUS_AUDIOF_ENVIRON | Environmental modeling. |
| DMUS_AUDIOF_EAX | EAX effects. |
| DMUS_AUDIOF_DMOS | Additional |
| DMUS_AUDIOF_STREAMING | Support for streaming waves. |
dwVoices
Number of voices. The default value is 64.
dwSampleRate
Sample rate of sink and synthesizer, in the range from 11,025 to 96,000 kHz. The default value is 22,050.
clsidDefaultSynth
Class identifier of the default synthesizer. This is the synthesizer used by standard audiopaths and audiopaths created from configurations that request the default synthesizer.
Requirements
Header: Declared in dmusicf.h.