acmStreamReset function (msacm.h)

Article
02/22/2024

The acmStreamReset function stops conversions for a given ACM stream. All pending buffers are marked as done and returned to the application.

Syntax

MMRESULT ACMAPI acmStreamReset(
  HACMSTREAM has,
  DWORD      fdwReset
);

Parameters

has

Handle to the conversion stream.

fdwReset

Reserved; must be zero.

Return value

Returns zero if successful or an error otherwise. Possible error values include the following.

Return code	Description
MMSYSERR_INVALFLAG	At least one flag is invalid.
MMSYSERR_INVALHANDLE	The specified handle is invalid.

Remarks

Resetting an ACM conversion stream is necessary only for asynchronous conversion streams. Resetting a synchronous conversion stream will succeed, but no action will be taken.

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	msacm.h
Library	Msacm32.lib
DLL	Msacm32.dll