waveInProc

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 dwInstance,  
  DWORD dwParam1,    
  DWORD dwParam2     
);
 

Parameters

hwi

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

uMsg

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

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 parameters.

dwParam2

Message parameters.

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Import Library: User-defined.

See Also

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