IXAudio2MasteringVoice::GetChannelMask-Methode (xaudio2.h)

Gibt die Kanalmaske für diese Stimme zurück.

Syntax

HRESULT GetChannelMask(
  [out] DWORD *pChannelmask
);

Parameter

[out] pChannelmask

Gibt die Kanalmaske für diese Stimme zurück. Dies entspricht dem dwChannelMask-Element der WAVEFORMATEXTENSIBLE-Struktur .

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Das pChannelMask-Argument ist eine Bitmaske der verschiedenen Kanäle in der vom Audiosystem gemeldeten Lautsprechergeometrie. Diese Informationen werden für den X3DAudioInitializeSpeakerChannelMask-Parameter benötigt.

Die X3DAUDIO. Der H-Header deklariert eine Reihe von SPEAKER_ Positionsdefinitionen, um diese Kanalmasken zu decodieren.

Beispiele:

SPEAKER_STEREO // SPEAKER_FRONT_LEFT (0x1) | SPEAKER_FRONT_RIGHT (0x2) 

SPEAKER_5POINT1 // SPEAKER_FRONT_LEFT (0x1) | SPEAKER_FRONT_RIGHT (0x2)
                                    // | SPEAKER_FRONT_CENTER (0x4)
                                    // | SPEAKER_LOW_FREQUENCY (0x8)
                                    // | SPEAKER_BACK_LEFT (0x10) | SPEAKER_BACK_RIGHT (0x20)

Hinweis Für die DirectX SDK-Versionen von XAUDIO wurde die Kanalmaske für das Ausgabegerät über die IXAudio2::GetDeviceDetails-Methode abgerufen, die in Windows 8 und höher nicht vorhanden ist.

 

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8)

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	xaudio2.h

Weitere Informationen

IXAudio2MasteringVoice