MPEG2_FILTER Structure

The MPEG2_FILTER structure specifies criteria for matching MPEG-2 section headers.

Syntax

typedef struct {
    BYTE  bVersionNumber;
    WORD  wFilterSize;
    BOOL  fUseRawFilteringBits;
    BYTE  Filter[16];
    BYTE  Mask[16];
    BOOL  fSpecifyTableIdExtension;
    WORD  TableIdExtension;
    BOOL  fSpecifyVersion;
    BYTE  Version;
    BOOL  fSpecifySectionNumber;
    BYTE  SectionNumber;
    BOOL  fSpecifyCurrentNext;
    BOOL  fNext;
    BOOL  fSpecifyDsmccOptions;
    DSMCC_FILTER_OPTIONS  Dsmcc;
    BOOL  fSpecifyAtscOptions;
    ATSC_FILTER_OPTIONS  Atsc;
} MPEG2_FILTER, *PMPEG2_FILTER;

Members

bVersionNumber

Specifies the version number of the structure. This value must be 1 or higher.

wFilterSize

Specifies the size of the structure data, excluding any padding bytes. Set this field equal to the constant MPEG2_FILTER_VERSION_1_SIZE.

fUseRawFilteringBits

If this flag is TRUE, the Filter and Mask members specify the filtering criteria as a pair of bit masks, and the remaining members of this structure are ignored. If this field is FALSE, the Filter and Mask members are ignored, and the other structure members contain the filtering criteria.

Filter

Specifies a 16-byte bit mask, which contains the bit values to match in the section header.

Mask

Specifies a 16-byte bit mask. Set any "don't care" bits equal to 1, and all other bits to 0. In other words, for each bit, if the value in Mask is 0, the corresponding bit in Filter will be matched against that bit in the section header. If the value in Mask is 1, that bit in the section header is ignored.

fSpecifyTableIdExtension

If this flag is TRUE, the table_ID_extension field in the header must match the value of the TableIdExtension structure member. Otherwise, the table_ID_extension field is ignored.

TableIdExtension

Specifies a value for the table_ID_extension field.

fSpecifyVersion

If this flag is TRUE, the version_number field in the header must match the value of the Version structure member. Otherwise, the version_number field is ignored.

Version

Specifies a value for the version_number field.

fSpecifySectionNumber

If this flag is TRUE, the section_number field in the header must match the value of the SectionNumber structure member. Otherwise, the section_number field is ignored.

SectionNumber

Specifies a value for the section_number field.

fSpecifyCurrentNext

If this flag is TRUE, the current_next_indicator bit in the header must match the value of the fNext structue member. Otherwise, the current_next_indicator field is ignored.

fNext

Specifies a value for the current_next_indicator bit. You can use the MPEG_CURRENT_NEXT_BIT enumeration type to specify this value.

fSpecifyDsmccOptions

If this field is TRUE, the Dsmcc member contains additional filtering criteria for the DSM-CC portions of the section header. Otherwise, the Dsmcc member is ignored.

Dsmcc

Specifies a DSMCC_FILTER_OPTIONS structure that contains additional filtering criteria for the DSM-CC portions of the section header.

fSpecifyAtscOptions

If this flag is TRUE, the Atsc member contains additional filtering criteria. Otherwise, the Atsc member is ignored.

Atsc

Specifies an ATSC_FILTER_OPTIONS structure that contains additional filtering criteria.

See Also

• MPEG-2 Section and Table Structures