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 |