IPMT::QueryServiceGatewayInfo Method

Article
01/07/2009

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

Syntax

HRESULT QueryServiceGatewayInfo(
  [out]  DSMCC_ELEMENT **ppDSMCCList,
  [out]  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 Value

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

Declared in Mpeg2PsiParser.h.