IPMT::QueryServiceGatewayInfo

  • Article
 
Microsoft DirectShow 9.0

IPMT::QueryServiceGatewayInfo

The QueryServiceGatewayInfo method returns the DSM-CC service gateway information in the PMT, if any.

Syntax

  HRESULT QueryServiceGatewayInfo(
  DSMCC_ELEMENT**  ppDSMCCList,
  UINT*  puiCount
);

Parameters

ppDSMCCList

[out]  Address of a variable that receives a pointer to an array of DSMCC_ELEMENT structures. The client must free the array by calling the CoTaskMemFree function.

puiCount

[out]  Receives the number of elements returned in ppDSMCCList.

Return Values

The method returns an HRESULT. Possible values include those in the following table.

Return code Description
E_OUTOFMEMORY Insufficient memory.
E_POINTER NULL pointer argument.
MPEG2_E_MALFORMED_TABLE Malformed table.
MPEG2_S_SG_INFO_FOUND Service gateway information was found in the PMT.
MPEG2_S_SG_INFO_NOT_FOUND Service gateway information was not found in the PMT.

Remarks

If the method succeeds, it returns one of the two success codes listed in the previous table. It returns MPEG2_S_SG_INFO_FOUND if the PMT contains service gateway information, or MPEG2_S_SG_INFO_NOT_FOUND if the PMT does not contain any service gateway information.

Requirements

Header: Include Mpeg2PsiParser.h.

See Also