Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

waveOutProc callback function

The waveOutProc function is the callback function used with the waveform-audio output device. The waveOutProc 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 waveOutOpen function.

Syntax


void CALLBACK waveOutProc(
  HWAVEOUT hwo,
  UINT uMsg,
  DWORD_PTR dwInstance,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parameters

hwo

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

uMsg

Waveform-audio output message. It can be one of the following values.

Value Meaning
WOM_CLOSE Sent when the device is closed using the waveOutClose function.
WOM_DONE Sent when the device driver is finished with a data block sent using the waveOutWrite function.
WOM_OPEN Sent when the device is opened using the waveOutOpen function.

 

dwInstance

User-instance data specified with waveOutOpen.

dwParam1

Message parameter.

dwParam2

Message parameter.

Return value

This function does not return a value.

Remarks

The meaning of the two message parameters, dwParam1 and dwParam2, depends on the message specified in uMsg. The documentation for each message describes the message parameters.

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

 

 

Community Additions

Show:
© 2014 Microsoft