WAVEOUTCAPSA 结构 (mmeapi.h)

WAVEOUTCAPS 结构描述了波形音频输出设备的功能。

语法

typedef struct tagWAVEOUTCAPSA {
  WORD      wMid;
  WORD      wPid;
  MMVERSION vDriverVersion;
  CHAR      szPname[MAXPNAMELEN];
  DWORD     dwFormats;
  WORD      wChannels;
  WORD      wReserved1;
  DWORD     dwSupport;
} WAVEOUTCAPSA, *PWAVEOUTCAPSA, *NPWAVEOUTCAPSA, *LPWAVEOUTCAPSA;

成员

wMid

设备的设备驱动程序的制造商标识符。 制造商标识符在 制造商和产品标识符中定义。

wPid

设备的产品标识符。 产品标识符在 制造商和产品标识符中定义。

vDriverVersion

设备的设备驱动程序的版本号。 高阶字节是主要版本号,低序字节是次要版本号。

szPname[MAXPNAMELEN]

以 null 结尾的字符串中的产品名称。

dwFormats

支持的标准格式。 可以是以下各项的组合:

格式 描述
WAVE_FORMAT_1M08 11.025 kHz、单声道、8 位
WAVE_FORMAT_1M16 11.025 kHz、单声道、16 位
WAVE_FORMAT_1S08 11.025 kHz、立体声、8 位
WAVE_FORMAT_1S16 11.025 kHz、立体声、16 位
WAVE_FORMAT_2M08 22.05 kHz、单声道、8 位
WAVE_FORMAT_2M16 22.05 kHz、单声道、16 位
WAVE_FORMAT_2S08 22.05 kHz、立体声、8 位
WAVE_FORMAT_2S16 22.05 kHz、立体声、16 位
WAVE_FORMAT_4M08 44.1 kHz、单声道、8 位
WAVE_FORMAT_4M16 44.1 kHz、单声道、16 位
WAVE_FORMAT_4S08 44.1 kHz、立体声、8 位
WAVE_FORMAT_4S16 44.1 kHz、立体声、16 位
WAVE_FORMAT_96M08 96 kHz、单声道、8 位
WAVE_FORMAT_96M16 96 kHz、单声道、16 位
WAVE_FORMAT_96S08 96 kHz,立体声,8 位
WAVE_FORMAT_96S16 96 kHz,立体声,16 位

wChannels

指定设备是否支持单声道(1)或立体声(2)输出的数字。

wReserved1

dwSupport

设备支持的可选功能。 定义了以下值:

描述
WAVECAPS_LRVOLUME 支持单独的左右音量控制。
WAVECAPS_PITCH 支持音调控制。
WAVECAPS_PLAYBACKRATE 支持播放速率控制。
WAVECAPS_SYNC 驱动程序是同步的,在播放缓冲区时将阻止。
WAVECAPS_VOLUME 支持音量控制。
WAVECAPS_SAMPLEACCURATE 返回样本准确的位置信息。

言论

如果设备支持卷更改,将为 dwSupport 成员设置WAVECAPS_VOLUME标志。 如果设备支持左侧和右侧通道上的单独卷更改,则会为此成员设置WAVECAPS_VOLUME和WAVECAPS_LRVOLUME标志。

注意

mmeapi.h 标头将 WAVEOUTCAPS 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 mmeapi.h (包括 Windows.h)

另请参阅

波形音频

波形结构