ACMDM_STREAM_RESET (Windows Embedded CE 6.0)

1/6/2010

This message requests an ACM driver to stop conversion operations for the specified stream.

Parameters

• dwDeviceID
  Value that specifies a driver instance identifier. The driver returns this value in response to the ACM_Open (ACM Driver) function.

• hDriver
  Handle to a driver.

• uMsg
  Value that specifies this message.

• lParam1
  Pointer to an ACMDRVSTREAMINSTANCE structure.

• lParam2
  Value that contains the fdwReset parameter of the acmStreamReset function.

Return Values

A return value of MMSYSERR_NOERROR indicates success. Otherwise, the driver returns one of the MMSYSERR error values declared in the Mmsystem.h header file or one of the ACMERR error values declared in the Msacm.h header file.

Remarks

The ACM (Waveapi.dll) sends this message by calling the ACM driver's ACM_IOControl entry point through the DeviceIoControl function. The ACM sends this message when an application calls the acmStreamReset function. Only asynchronous drivers receive this message. If a client calls acmStreamReset for a synchronous driver, the ACM returns MMSYSERR_NOERROR without calling the driver.

When an asynchronous driver receives this message, it sets the ACMSTREAMHEADER_STATUSF_DONE flag and clears the ACMSTREAMHEADER_STATUSF_INQUEUE flag in every ACMDRVSTREAMHEADER structure contained in its conversion queue.

Requirements

See Also

Reference

ACM_Open (ACM Driver)
ACMDRVSTREAMINSTANCE
ACM_IOControl

Concepts

ACM Driver Messages