waveOutGetPosition 函数 (mmeapi.h)

waveOutGetPosition 函数检索给定波形音频输出设备的当前播放位置。

语法

MMRESULT waveOutGetPosition(
  HWAVEOUT hwo,
  LPMMTIME pmmt,
  UINT     cbmmt
);

parameters

hwo

波形音频输出设备的句柄。

pmmt

指向 MMTIME 结构的指针。

cbmmt

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

返回值

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

返回代码 说明
MMSYSERR_INVALHANDLE
指定的设备句柄无效。
MMSYSERR_NODRIVER
不存在设备驱动程序。
MMSYSERR_NOMEM
无法分配或锁定内存。

注解

在调用此函数之前,请设置 MMTIME 结构的 wType 成员以指示所需的时间格式。 调用此函数后,检查 wType 以确定时间格式是否受支持。 如果格式不受支持, wType 将指定备用格式。

打开或重置设备时,位置设置为零。

要求

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

另请参阅

波形音频

波形函数