Share via

capSetCallbackOnWaveStream

  • Article

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.

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 Values

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

**  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 Vfw.h.

See Also

Video Capture, Video Capture Macros, capWaveStreamCallback, WM_CAP_SET_CALLBACK_WAVESTREAM