Language
Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Windows Media Audio 9 encoder object is instantiated using the class identifier CLSID_CWMAEncMediaObject. The decoder object is instantiated using the class identifier CLSID_CWMADecMediaObject. Windows Media Audio 9 encoded content is identified by the audio tag 0x161.
Encoder Properties
The following properties can be set on the Windows Media Audio 9 encoder.
| Property | Description |
|---|---|
| MFPKEY_BAVG | Specifies the buffer window, in milliseconds, of a constrained variable-bit-rate (VBR) stream at its average bit rate (specified by MFPKEY_RAVG). |
| MFPKEY_BMAX | Specifies the buffer window, in milliseconds, of a constrained variable-bit-rate (VBR) stream at its peak bit rate (specified by MFPKEY_RMAX). |
| MFPKEY_DECODERCOMPLEXITYPROFILE | Specifies the device conformance template to which the encoded content conforms. |
| MFPKEY_ENDOFPASS | Specifies the end of an encoding pass. |
| MFPKEY_MAXENCLATENCYMS | Specifies the maximum latency for the encoder, in milliseconds. |
| MFPKEY_PASSESRECOMMENDED | Specifies the maximum number of passes supported by the codec. |
| MFPKEY_PASSESUSED | Specifies the number of passes that the codec will use to encode the content. |
| MFPKEY_RAVG | Specifies the average bit rate, in bits per second, used for 2-pass variable-bit-rate (VBR) encoding. |
| MFPKEY_RMAX | Specifies the peak bit rate, in bits per second, used for constrained 2-pass variable-bit-rate (VBR) encoding. |
| MFPKEY_VBRENABLED | Specifies whether the codec will use variable-bit-rate (VBR) encoding. |
| MFPKEY_WMAENC_AVGBYTESPERSEC | Specifies the average bytes per second in a quality-based variable-bit-rate (VBR) audio stream. |
| MFPKEY_WMAENC_ORIGWAVEFORMAT | Specifies the WAVEFORMATEX structure describing the input audio content. |
Decoder Properties
The following properties can be read on the Windows Media Audio 9 decoder.
| Property | Description |
|---|---|
| MFPKEY_Decoder_MaxNumPCMSamplesWithPaddedSilence | Specifies the maximum number of additional PCM samples that might be returned at the end of decoding a file. |
The following properties can be set on the Windows Media Audio 9 decoder.
| Property | Description |
|---|---|
| MFPKEY_BMAX | Specifies the buffer window, in milliseconds, of a constrained variable-bit-rate (VBR) stream at its peak bit rate (specified by MFPKEY_RMAX). |
| MFPKEY_ENDOFPASS | Specifies the end of an encoding pass. |
| MFPKEY_MAXDECLATENCYMS | Specifies the maximum latency for the decoder, in milliseconds. |
| MFPKEY_PASSESRECOMMENDED | Specifies the maximum number of passes supported by the codec. |
| MFPKEY_PASSESUSED | Specifies the number of passes that the codec will use to encode the content. |
| MFPKEY_RMAX | Specifies the peak bit rate, in bits per second, used for constrained 2-pass variable-bit-rate (VBR) encoding. |
| MFPKEY_VBRENABLED | Specifies whether the codec will use variable-bit-rate (VBR) encoding. |
Remarks
An audio encoder or decoder object exposes the IMediaObject interface so that the object can be used as a DirectX Media Object (DMO), and the IMFTransform interface so that the object can be used as a Media Foundation Transform (MFT).
A Windows Media Audio 9 encoder or decoder behaves as a DMO or an MFT depending on which interfaces you obtain and which version of Windows is running. The following table shows the conditions under which an Audio 9 encoder or decoder behaves as a DMO or an MFT.
| Operating system | Encoder or decoder behavior |
|---|---|
| Windows XP | A Windows Media Audio 9 encoder or decoder always behaves as a DMO. |
| Windows Vista | By default, a Windows Media Audio 9 encoder or decoder behaves as a DMO. If you obtain an IMFTransform interface or an IPropertyStore interface on an Audio 9 encoder or decoder, it behaves as an MFT. |
| Windows 7 | By default, a Windows media Audio 9 encoder or decoder behaves as a DMO. If you obtain an IMFTransform interface on an Audio 9 encoder or decoder, it behaves as an MFT. |
Requirements
| Client | Requires Windows XP, Windows Vista, or Windows 7. |
| Header | Declared in Wmcodecdsp.h. |
| Library | Use Wmadmoe.dll for the encoder or wmadmod.dll for the decoder. |
See Also
Codec Objects
Codec Implementation
Using the Windows Media Audio 9 Codec
Send comments about this topic to Microsoft
Build date: 1/27/2009