waveInProc

  • Article

The waveInProc function is the callback function used with the waveform-audio input device. This function is a placeholder for the application-defined function name. The address of this function can be specified in the callback-address parameter of the waveInOpen function.

void CALLBACK waveInProc(
  HWAVEIN hwi,       
  UINT uMsg,         
  DWORD_PTR dwInstance,  
  DWORD_PTR dwParam1,    
  DWORD_PTR dwParam2     
);

Parameters

hwi

Handle to the waveform-audio device associated with the callback function.

uMsg

Waveform-audio input message. It can be one of the following messages.

Value Meaning
WIM_CLOSE Sent when the device is closed using the waveInClose function.
WIM_DATA Sent when the device driver is finished with a data block sent using the waveInAddBuffer function.
WIM_OPEN Sent when the device is opened using the waveInOpen function.

dwInstance

User instance data specified with waveInOpen.

dwParam1

Message parameter.

dwParam2

Message parameter.

Return Values

This function does not return a value.

Remarks

Applications should not call any system-defined functions from inside a callback function, except for EnterCriticalSection, LeaveCriticalSection, midiOutLongMsg, midiOutShortMsg, OutputDebugString, PostMessage, PostThreadMessage, SetEvent, timeGetSystemTime, timeGetTime, timeKillEvent, and timeSetEvent. Calling other wave functions will cause deadlock.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Mmsystem.h; include Windows.h.

See Also

Waveform Audio, Waveform Functions, EnterCriticalSection, LeaveCriticalSection, midiOutLongMsg, midiOutShortMsg, OutputDebugString, PostMessage, PostThreadMessage, SetEvent, timeGetSystemTime, timeGetTime, timeKillEvent, timeSetEvent, waveInAddBuffer, waveInClose, waveInOpen, WIM_DATA, WIM_CLOSE, WIM_OPEN