mixerGetDevCapsW 函数 (mmeapi.h)

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

语法

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

uMxId

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

pmxcaps

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

cbmxcaps

MIXERCAPS 结构的大小（以字节为单位）。

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

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

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

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

注意

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


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