Share via

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)

另请参阅

波形音频

波形结构