waveOutGetDevCaps 函数 (mmeapi.h)

waveOutGetDevCaps 函数检索给定波形音频输出设备的功能。

Syntax

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

参数

uDeviceID

波形音频输出设备的标识符。 它可以是设备标识符,也可以是开放波形音频输出设备的句柄。

pwoc

指向要填充设备功能的 WAVEOUTCAPS 结构的指针。

cbwoc

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

返回值

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

返回代码 Description
MMSYSERR_BADDEVICEID 指定的设备标识符范围不足。
MMSYSERR_NODRIVER 不存在任何设备驱动程序。
MMSYSERR_NOMEM 无法分配或锁定内存。

注解

使用 waveOutGetNumDevs 函数确定系统中存在的波形音频输出设备的数量。 如果 uDeviceID 参数指定的值是设备标识符,则该值可能会从零更改为一个小于现有设备数。 WAVE_MAPPER常量还可以用作设备标识符。 仅 将 cbwoc 字节(或更少)的信息复制到 pwoc 指向的位置。 如果 cbwoc 为零,则不会复制任何内容,并且函数返回零。

要求

Requirement 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows操作系统
Header mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

波形音频

波形函数