waveInGetPosition

Syntax

WORD waveInGetPosition(hWaveIn, lpInfo, wSize)

This function retrieves the current input position of the specified waveform input device.

Parameters

HWAVEIN hWaveIn

Specifies a handle to the waveform input device.

LPMMTIME lpInfo

Specifies a far pointer to an MMTIME structure.

WORD wSize

Specifies the size of the MMTIME structure.

Return Value

Returns zero if the function was successful. Possible error returns are:

MMSYSERR_INVALHANDLE

Specified device handle is invalid.

Comments

Before calling waveInGetPosition, set the wType field of the MMTIME structure to indicate the time format that you desire. After calling waveInGetPosition, be sure to check the wType field to determine if the desired time format is supported. If the desired format is not supported, wType will specify an alternative format.

The position is set to zero when the device is opened or reset.