WAVEOUTCAPS 结构 (mmeapi.h)

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

语法

typedef struct waveoutcaps_tag {
  WORD    wMid;
  WORD    wPid;
  VERSION vDriverVersion;
  char    szPname[MAXPNAMELEN];
  DWORD   dwFormats;
  WORD    wChannels;
  DWORD   dwSupport;
} WAVEOUTCAPS, *PWAVEOUTCAPS, *NPWAVEOUTCAPS, *LPWAVEOUTCAPS;

成员

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) 输出的数字。

dwSupport

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

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

注解

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

要求

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

另请参阅

波形音频

波形结构