capSetCallbackOnWaveStream macro (vfw.h)

The capSetCallbackOnWaveStream macro sets a callback function in the application. AVICap calls this procedure during streaming capture when a new audio buffer becomes available. You can use this macro or explicitly call the WM_CAP_SET_CALLBACK_WAVESTREAM message.

Syntax

BOOL capSetCallbackOnWaveStream(
     hwnd,
     fpProc
);

Parameters

hwnd

Handle to a capture window.

fpProc

Pointer to the wave stream callback function, of type capWaveStreamCallback. Specify NULL for this parameter to disable a previously installed wave stream callback function.

Return value

Type: BOOL

Returns TRUE if successful or FALSE if streaming capture or a single-frame capture session is in progress.

Remarks

The capture window calls the procedure before writing the audio buffer to disk. This allows applications to modify the audio buffer if desired.

If a wave stream callback function is used, it must be installed before starting the capture session and it must remain enabled for the duration of the session. It can be disabled after streaming capture ends.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	vfw.h

See also

Video Capture

Video Capture Macros