mciSetYieldProc

The mciSetYieldProc function sets the address of a procedure to be called periodically when an MCI device is waiting for a command to finish because the "wait" (MCI_WAIT) flag was specified.

UINT mciSetYieldProc(
  MCIDEVICEID IDDevice,  
  YIELDPROC yp,          
  DWORD dwYieldData      
);
 

Parameters

IDDevice

Identifier of the device to assign a procedure to.

yp

Address of the procedure to call when yielding for the specified device. If this parameter is NULL, the function disables any existing yield procedure.

dwYieldData

Data to be sent to the yield procedure when it is called for the specified device.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

This function overrides any previous yield procedure for this device.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.
  Import Library: Use winmm.lib.

See Also

MCI Overview, MCI Functions