| Microsoft DirectX 9.0 SDK Update (Summer 2004) |
IDirectMusicPerformance8::CreateStandardAudioPath
The CreateStandardAudioPath method creates an audiopath with a standard configuration.
Syntax
HRESULT CreateStandardAudioPath(
DWORD dwType,
DWORD dwPChannelCount,
BOOL fActivate,
IDirectMusicAudioPath **ppNewPath
);
Parameters
dwType
Type of the path. The following values are defined.
| Value | Description |
| DMUS_APATH_DYNAMIC_3D | One bus to a 3-D buffer. Does not send to environmental reverb. |
| DMUS_APATH_DYNAMIC_MONO | One bus to a mono buffer. |
| DMUS_APATH_DYNAMIC_STEREO | Two buses to a stereo buffer. |
| DMUS_APATH_SHARED_STEREOPLUSREVERB | Ordinary music setup with stereo outs and reverb. |
dwPChannelCount
Number of
fActivate
Boolean value that specifies whether to activate the path on creation.
ppNewPath
Address of a variable that receives an IDirectMusicAudioPath interface pointer for the audiopath. See IDirectMusicAudioPath8.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| DMUS_E_AUDIOPATHS_NOT_VALID |
| DMUS_E_NOT_INIT |
| DSERR_BUFFERLOST |
| E_INVALIDARG |
| E_OUTOFMEMORY |
| E_POINTER |
Remarks
The method fails with DSERR_BUFFERLOST if any application has initialized DirectSound with the write-primary cooperative level.
Requirements
Header: Declared in dmusici.h.
See Also
© 2004 Microsoft Corporation. All rights reserved.