Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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 waveInOpenfunction.

Syntax 

void CALLBACK waveInProc(
  HWAVEIN
 hwi,
  UINT
 uMsg,
  DWORD
 dwInstance,
  DWORD
 dwParam1,
  DWORD
 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 messages shown in the following table.

Message Description

WIM_CLOSE

Sent when the device is closed using the waveInClosefunction.

WIM_DATA

Sent when the device driver is finished with a data block sent using the waveInAddBufferfunction.

WIM_OPEN

Sent when the device is opened using the waveInOpenfunction.
dwInstance

User instance data specified with waveInOpen.

dwParam1

Message parameter.

dwParam2

Message parameter.

Return Value

None.

Remarks

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

Requirements

Header mmsystem.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also