mixerGetDevCaps 函数 (mmeapi.h)

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

语法

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS pmxcaps,
  UINT        cbmxcaps
);

参数

uMxId

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

pmxcaps

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

cbmxcaps

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

返回值

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

返回代码 说明
MMSYSERR_BADDEVICEID
指定的设备标识符在范围外。
MMSYSERR_INVALHANDLE
混音器设备句柄无效。
MMSYSERR_INVALPARAM
一个或多个参数无效。

注解

使用 mixerGetNumDevs 函数确定系统中存在的混音器设备数。 uMxId 指定的设备标识符从 0 到 1 不等,比存在的混音器设备数少。

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

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

要求

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

另请参阅

音频混音器函数

音频混音器