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) |