mixerGetDevCapsW 函数 (mmeapi.h)

mixerGetDevCaps 函数查询指定的混音器设备以确定其功能。

语法

MMRESULT mixerGetDevCapsW(
  UINT_PTR     uMxId,
  LPMIXERCAPSW pmxcaps,
  UINT         cbmxcaps
);

参数

uMxId

打开的混音器设备的标识符或句柄。

pmxcaps

指向接收设备功能信息的 MIXERCAPS 结构的指针。

cbmxcaps

MIXERCAPS 结构的大小(以字节为单位)。

返回值

如果成功或错误,则返回MMSYSERR_NOERROR。 可能的错误值包括以下内容。

返回代码 描述
MMSYSERR_BADDEVICEID
指定的设备标识符范围不足。
MMSYSERR_INVALHANDLE
混音器设备句柄无效。
MMSYSERR_INVALPARAM
一个或多个参数无效。

言论

使用 mixerGetNumDevs 函数来确定系统中存在的混音器设备数。 由 uMxId 指定的设备标识符从零到一个不同,而不是存在的混音器设备数。

仅将 cbmxcaps 中指定的信息的字节数(或更少)复制到 pmxcaps指向的位置。 如果 cbmxcaps 为零,则不会复制任何内容,并且函数将成功返回。

此函数还接受由 mixerOpen 函数返回的混音器设备句柄作为 uMxId 参数。 应用程序应将 HMIXER 句柄强制转换为 UINT

注意

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

要求

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

另请参阅

音频混音器函数

音频混音器