waveInGetPosition

	MMRESULT waveInGetPosition(hWaveIn, lpInfo, wSize)
	HWAVEIN hWaveIn;
	LPMMTIME lpInfo;
	UINT wSize;

The waveInGetPosition function retrieves the current input position of the specified waveform input device.

Parameters

hWaveIn

Specifies a handle to the waveform input device.

lpInfo

Specifies a far pointer to an MMTIME structure.

wSize

Specifies the size of the MMTIME structure.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

Value

Meaning

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.