waveInProc callback function

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.

Syntax

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 value

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mmsystem.h (include Windows.h)

See also

Waveform Audio

Waveform Functions