AUDCLNT_SHAREMODE Enumeration
| Previous | Next |
AUDCLNT_SHAREMODE Enumeration
The AUDCLNT_SHAREMODE enumeration defines constants that indicate whether an audio stream will run in shared mode or in exclusive mode.
typedef enum _AUDCLNT_SHAREMODE {
AUDCLNT_SHAREMODE_SHARED,
AUDCLNT_SHAREMODE_EXCLUSIVE
} AUDCLNT_SHAREMODE;
Members
AUDCLNT_SHAREMODE_SHARED
The audio stream will run in shared mode. For more information, see Remarks.
AUDCLNT_SHAREMODE_EXCLUSIVE
The audio stream will run in exclusive mode. For more information, see Remarks.
Remarks
The IAudioClient::Initialize and IAudioClient::IsFormatSupported methods use the constants defined in the AUDCLNT_SHAREMODE enumeration.
In shared mode, the client can share the audio endpoint device with clients that run in other user-mode processes. The audio engine always supports formats for client streams that match the engine's mix format. In addition, the audio engine might support another format if the Windows audio service can insert system effects into the client stream to convert the client format to the mix format.
In exclusive mode, the Windows audio service attempts to establish a connection in which the client has exclusive access to the audio endpoint device. In this mode, the audio engine inserts no system effects into the local stream to aid in the creation of the connection point. Either the audio device can handle the specified format directly or the method fails.
For more information about shared-mode and exclusive-mode streams, see User-Mode Audio Components.
Requirements
Client: Windows Vista
Header: Include Audiosessiontypes.h
See Also
| Previous | Next |