HeadsetOperation 枚举

定义

可从支持它们的头戴显示设备读取或写入的设置。

public enum class HeadsetOperation
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Gaming.Input.GamingInputPreviewContract, 131072)]
enum class HeadsetOperation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Gaming.Input.GamingInputPreviewContract), 131072)]
public enum HeadsetOperation
var value = Windows.Gaming.Input.Preview.HeadsetOperation.geq
Public Enum HeadsetOperation
继承
HeadsetOperation
属性

Windows 要求

设备系列
Windows Desktop Extension SDK (在 10.0.23665.0 中引入)
API contract
Windows.Gaming.Input.GamingInputPreviewContract (在 v2.0 中引入)

字段

BassBoostGain 1

控制低音提升。 缓冲区必须是介于 0 到 12 分贝(含 0 和 12 分贝)之间的小端 4 字节有符号整数。

Geq 0

控制均衡器。 缓冲区必须是布局与 HeadsetGeqGains 结构相同的字节数组。

MuteLedBrightness 4

控制静音 LED 亮度。 缓冲区必须是设置为 HeadsetLevel.Low、HeadsetLevel.Medium 或 HeadsetLevel.High 的无符号 1 字节整数。

SideTone 3

控制侧音功能。 缓冲区必须是设置为 HeadsetLevel 枚举值之一的无符号 1 字节整数。

SmartMute 2

控制智能静音功能。 缓冲区必须是设置为 HeadsetLevel 枚举值之一的无符号 1 字节整数。

SwapMixAndVolumeDials 5

控制混合和音量拨盘是就地还是交换。 缓冲区必须是一个字节布尔值;如果拨盘就地,则为 false;如果交换拨盘,则为 true。

示例

public void SetupHeadset(IGameControllerProvider headsetProvider)
{
    LegacyGipGameControllerProvider legacyGipGameControllerProvider =
        LegacyGipGameControllerProvider.FromGameControllerProvider(headsetProvider);

    // Reset the device
    legacyGipGameControllerProvider.ExecuteCommand(DeviceCommand.Reset);

    // Check the smart mute level
    byte[] smartMuteBuffer =
        legacyGipGameControllerProvider.GetHeadsetOperation(HeadsetOperation.SmartMute);
    HeadsetLevel smartMuteValue = (HeadsetLevel)smartMuteBuffer[0];

    // Set bass boost to 3db
    byte[] bassBuffer = BitConverter.GetBytes((UInt32)3);
    legacyGipGameControllerProvider.SetHeadsetOperation(HeadsetOperation.BassBoostGain,
        bassBuffer);
}

注解

注意

为了避免损坏设备,头戴显示设备控制 API 应仅用于你开发的硬件。

适用于

另请参阅