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