Name

 
waveOutGetPosition --- Query the current playback position
 
 

Syntax

 #include <mme/mme_api.h>
 MMRESULT waveOutGetPosition(HWAVEOUT hWaveOut,
                            LPMMTIME lpInfo,
                            UINT uSize);
 

Arguments

 
HWAVEOUT hWaveOut
Specifies a handle to a waveform audio output device.

 
LPMMTIME lpInfo
Specifies a pointer to an MMTIME data structure. The MMTIME data structure must be allocated with the mmeAllocMem function before being passed to the waveOutGetPosition function. 
 
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures. 
 
 

 
UINT uSize
Specifies the size of the MMTIME data structure. 
 
 

Description

 
The waveOutGetPosition function queries the current playback position of the specified waveform audio output device. Before calling the waveOutGetPosition function, set the wType field of the MMTIME data structure to indicate the desired time format. After calling the waveOutGetPosition function, check the wType field to determine if the desired time format is supported. If the desired format is not supported, the wType field specifies an alternative format. 
 

Extensions

 
None.
 
 

Return Values

 
Returns MMSYSERR_NOERROR if the function is successful; otherwise, it returns one of the following error codes:
 
 

 
MMSYSERR_INVALHANDLE@T{ The specified device handle is invalid. T} MMSYSERR_HANDLEBUSY@T{ The handle hWaveOut is in use on another thread.  T}

See Also

 
None.