IPMT::QueryServiceGatewayInfo method (mpeg2psiparser.h)

  • Articolo

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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

[out] ppDSMCCList

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.

[out] puiCount

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

Requirement Value
Target Platform Windows
Header mpeg2psiparser.h

See also

IPMT Interface