capSetCallbackOnWaveStream

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 of a capture window.
fpProc
Address of the wave stream callback function. 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

Video Capture Overview, Video Capture Macros, WM_CAP_SET_CALLBACK_WAVESTREAM