AUDCLNT_SHAREMODE Enumeration (audiosessiontypes.h)

Die AUDCLNT_SHAREMODE-Enumeration definiert Konstanten, die angeben, ob ein Audiostream im freigegebenen Modus oder im exklusiven Modus ausgeführt wird.

Syntax

typedef enum _AUDCLNT_SHAREMODE {
  AUDCLNT_SHAREMODE_SHARED,
  AUDCLNT_SHAREMODE_EXCLUSIVE
} AUDCLNT_SHAREMODE;

Konstanten

 
AUDCLNT_SHAREMODE_SHARED
Der Audiostream wird im freigegebenen Modus ausgeführt. Weitere Informationen finden Sie in den Hinweisen.
AUDCLNT_SHAREMODE_EXCLUSIVE
Der Audiostream wird im exklusiven Modus ausgeführt. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Die Methoden IAudioClient::Initialize und IAudioClient::IsFormatSupported verwenden die in der AUDCLNT_SHAREMODE-Enumeration definierten Konstanten.

Im freigegebenen Modus kann der Client das Audioendpunktgerät für Clients freigeben, die in anderen Benutzermodusprozessen ausgeführt werden. Die Audio-Engine unterstützt immer Formate für Clientstreams, die dem Mixformat der Engine entsprechen. Darüber hinaus unterstützt die Audio-Engine möglicherweise ein anderes Format, wenn der Windows-Audiodienst Systemeffekte in den Clientdatenstrom einfügen kann, um das Clientformat in das Mixformat zu konvertieren.

Im exklusiven Modus versucht der Windows-Audiodienst, eine Verbindung herzustellen, bei der der Client exklusiven Zugriff auf das Audioendpunktgerät hat. In diesem Modus fügt die Audio-Engine keine Systemeffekte in den lokalen Stream ein, um die Erstellung des Verbindungspunkts zu unterstützen. Entweder kann das Audiogerät das angegebene Format direkt verarbeiten, oder die Methode schlägt fehl.

Weitere Informationen zu Streams im freigegebenen Modus und exklusiven Modus finden Sie unter Audiokomponenten im Benutzermodus.For more information about shared-mode and exclusive-mode streams, see User-Mode Audio Components.

Ab dem Xbox Mai 2021 Update können Sie einen Audioclient im exklusiven Modus auf xbox öffnen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Kopfzeile audiosessiontypes.h

Weitere Informationen

Kernaudiokonstanten

Kernaudioaufzählungen

IAudioClient::Initialize

IAudioClient::IsFormatSupported