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_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