Name

 
waveInGetPosition --- Retrieve the current position of the specified waveform audio input device
 
 

Syntax

 #include <mme/mme_api.h>
 MMRESULT waveInGetPosition(HWAVEIN hWaveIn,
                           LPMMTIME lpInfo,
                           UINT uSize);
 

Arguments

 
HWAVEIN hWaveIn
Specifies a handle to a waveform audio input 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 waveInGetPosition 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 waveInGetPosition function retrieves the current position of the specified waveform audio input device. The position is set to zero when the device is opened or reset. 

 
Before calling the waveInGetPosition function, set the wType field of the MMTIME data structure to indicate the desired time format.  After calling the waveInGetPosition 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 the following error code:
 
 

 
MMSYSERR_INVALHANDLE@T{ The specified device handle is invalid. T}

See Also

 
None.