/usr/share/doc/wine-doc/html/winedev/msacm.htm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>MS ACM Dlls</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Wine Developer's Guide"
HREF="index.htm"><LINK
REL="UP"
TITLE="Wine and Multimedia"
HREF="multimedia.htm"><LINK
REL="PREVIOUS"
TITLE="High level layers"
HREF="mm-high.htm"><LINK
REL="NEXT"
TITLE="MS Video Dlls"
HREF="msvfw32.htm"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="winedoc.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Wine Developer's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="mm-high.htm"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 14. Wine and Multimedia</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="msvfw32.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="MSACM"
>14.6. MS ACM Dlls</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN4581"
>14.6.1. Contents</A
></H2
><P
>	  The MSACM32 (and its 16 bit sibbling MSACM) provide a way to
	  map a given wave format to another format. It also provides
	  filtering capabilities. Those DLLs only implement the proper
	  switch between a caller and a driver providing the
	  implementation of the requested format change or filter
	  operation.
	</P
><P
>	  There's nothing specific in Wine's implementation compared
	  to Windows' one. Here's however a list of the builtin format
	  change drivers (there's no filter driver yet):
	  <DIV
CLASS="TABLE"
><A
NAME="AEN4585"
></A
><P
><B
>Table 14-3. Wine ACM drivers</B
></P
><TABLE
BORDER="1"
FRAME="border"
RULES="all"
CLASS="CALSTABLE"
><COL><COL><THEAD
><TR
><TH
>Name</TH
><TH
>Provides</TH
></TR
></THEAD
><TBODY
><TR
><TD
>imaadp32</TD
><TD
>IMA ADPCM (adaptative PCM)</TD
></TR
><TR
><TD
>msadp32</TD
><TD
>Microsoft's ADPCM (adaptative PCM)</TD
></TR
><TR
><TD
>msg711</TD
><TD
>Microsoft's G.711 (A-Law and µ-Law)</TD
></TR
><TR
><TD
>winemp3</TD
><TD
>		    Wine's MP3 (MPEG Layer 3), based on mpglib library
		  </TD
></TR
></TBODY
></TABLE
></DIV
>
	</P
><P
>	  Note that Wine also supports native audio codecs as
	  well.
	</P
><P
>	  All builtin ACM drivers are 32 bit Unicode DLLs
	</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN4607"
>14.6.2. Caching</A
></H2
><P
>	  The MSACM/MSACM32 keeps some data cached for all known ACM
	  drivers. Under the key
          <PRE
CLASS="SCREEN"
>	  Software\Microsoft\AudioCompressionManager\DriverCache\&lt;driver name&gt;
	  </PRE
>
	  , are kept for values:
	  <P
></P
><UL
><LI
><P
>		<TT
CLASS="LITERAL"
>aFormatTagCache</TT
> which
		contains an array of <TT
CLASS="LITERAL"
>DWORD</TT
>. There
		are two <TT
CLASS="LITERAL"
>DWORD</TT
>s per <TT
CLASS="LITERAL"
>cFormatTags</TT
> 
		entry. The first <TT
CLASS="LITERAL"
>DWORD</TT
> contains a
		format tag value, and the second the associated
		maximum size for a <TT
CLASS="LITERAL"
>WAVEFORMATEX</TT
> structure.
		(Fields <TT
CLASS="LITERAL"
>dwFormatTag</TT
> and <TT
CLASS="LITERAL"
>cbFormatSize</TT
> from
		ACMFORMATDETAILS)
	      </P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>cFilterTags</TT
> contains the number of tags supported by the driver
		for filtering.
	      </P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>cFormatTags</TT
> contains the number of tags support
		by the driver for conversions.
	      </P
></LI
><LI
><P
>		<TT
CLASS="LITERAL"
>fdwSupport</TT
> (the same as the one returned from
		<CODE
CLASS="FUNCTION"
>acmDriverDetails</CODE
>).
	      </P
></LI
></UL
>
	</P
><P
>	  The <TT
CLASS="LITERAL"
>cFilterTags</TT
>,
	  <TT
CLASS="LITERAL"
>cFormatTags</TT
>,
	  <TT
CLASS="LITERAL"
>fdwSupport</TT
> are the same values as the
	  ones returned from <CODE
CLASS="FUNCTION"
>acmDriverDetails</CODE
> 
	  function.
	</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="mm-high.htm"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.htm"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="msvfw32.htm"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>High level layers</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="multimedia.htm"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>MS Video Dlls</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
wine-doc 1.0.0-1 / usr / share / doc / wine-doc / html / winedev / msacm.htm
