Microsoft DirectX 9.0

MPEG1WAVEFORMAT

The MPEG1WAVEFORMAT structure describes the format of MPEG-1 audio data.

Syntax

typedef struct mpeg1waveformat_tag {
    WAVEFORMATEX    wfx;
    WORD            fwHeadLayer;
    DWORD           dwHeadBitrate;
    WORD            fwHeadMode;
    WORD            fwHeadModeExt;
    WORD            wHeadEmphasis;
    WORD            fwHeadFlags;
    DWORD           dwPTSLow;
    DWORD           dwPTSHigh;
} MPEG1WAVEFORMAT;

Members

wfx

WAVEFORMATEX structure that contains information about the audio format. See Remarks.

fwHeadLayer

Specifies the MPEG audio layer, as defined by the following constants:

Value	Description
ACM_MPEG_LAYER1	Layer 1
ACM_MPEG_LAYER2	Layer 2
ACM_MPEG_LAYER3	Layer 3

Some MPEG stream may contain frames from more than one layer. If so, combine the flags with a bitwise OR.

dwHeadBitrate

Specifies the bitrate, in bits per second. This value gives the actual bitrate, not the MPEG frame header code. If the bitrate is variable, or is a non-standard bitrate, set this field to zero.

fwHeadMode

Specifies the stream mode, as defined by the following constants:

Value	Description
ACM_MPEG_STEREO	Stereo
ACM_MPEG_JOINTSTEREO	Joint stereo
ACM_MPEG_DUALCHANNEL	Dual channel
ACM_MPEG_SINGLECHANNEL	Single channel

Some MPEG streams may contain frames with different modes. If so, combine the flags with a bitwise OR.

fwHeadModeExt

Specifies the mode extension for joint-stereo encoding:

Value	MPEG Frame Header Code	Layers 1 and 2	Layer 3
0x01	'00'	Intensity stereo in bands 4 to 31	Intensity stereo off; Middle/Side (MS) stereo off
0x02	'01'	Intensity stereo in bands 8 to 31	Intensity stereo on; MS stereo off
0x04	'10'	Intensity stereo in bands 12 to 31	Intensity stereo off; MS stereo on
0x08	'11'	Intensity stereo in bands 16 to 31	Intensity stereo off; MS stereo on

These values may be combined with a bitwise OR. In general, encoders will dynamically switch between extension modes according to the characteristics of the signal. Therefore, for normal joint-stereo encoding, set this field to 0x0F (the bitwise OR of all the flags). However, you can use this field to limit the encoder to a set of allowable encoding types.

This field applies only when fwHeadMode includes ACM_MPEG_JOINTSTEREO. For other modes, set this field to zero.

wHeadEmphasis

Sepecifies the de-emphasis required by the decoder:

Value	MPEG Frame Header Code	De-emphasis Required
1	'00'	None
2	'01'	50/15 ms emphasis
3	'10'	Reserved
4	'11'	CCITT J.17

fwHeadFlags

Specifies a bitwise combination of zero or more of the following flags:

Value	Description
ACM_MPEG_PRIVATEBIT	Set the private bit.
ACM_MPEG_COPYRIGHT	Set the copyright bit.
ACM_MPEG_ORIGINALHOME	Set the original/home bit.
ACM_MPEG_PROTECTIONBIT	Set the protection bit, and insert a 16-bit error protection code into each frame.
ACM_MPEG_ID_MPEG1	Set the ID bit to 1, defining the stream as an MPEG-1 audio stream.

An encoder will use these flags to set the corresponding bits in the MPEG audio frame headers.

dwPTSLow

Specifies the least signifcant 32 bits of the presentation time stamp (PTS) of the first frame of the audio stream.

dwPTSHigh

Specifies the most significant bit of the PTS. The dwPTSLow and dwPTSHigh fields can be treated as a single 64-bit value.

Remarks

For MPEG-1 audio, the WAVEFORMATEX structure defined in the wfx member must have the following values.

WAVEFORMATEX Member	Description
wFormatTag	Must be WAVE_FORMAT_MPEG
nChannels	1 for mono, 2 for stereo
nSamplesPerSec	Specifies the sampling frequency, if the sampling frequency is fixed. If it is variable, set this field to zero.
nAvgBytesPerSec	Specifies the average data rate. If variable bitrate encoding is used under layer 3, the value might not be a legal MPEG-1 bit rate.
nBlockAlign	For audio streams with a fixed audio frame length, this field specifies the length of the audio frame. If the frame length is variable, set this field to 1. If the sampling frequency is 32 kHz or 48 kHz and the bit rate is constant, the audio frame size is constant. In that case, calculate nBlockAlign as follows: Layer 1: `4 * (int)(12 * bitrate / sampling frequency)` Layers 2 and 3: `(int)(144 * bitrate / sampling frequency)` If the bit rate is variable or the sampling frequency is 44.1 kHz, the audio frame size is not constant and nBlockAlign should be 1.
wBitsPerSample	Not used; set to zero.
cbSize	Specifies the size of the format data after the WAVEFORMATEX structure, in bytes. For the standard MPEG1WAVEFORMAT structure, this value is 22 bytes.

See Also