Share via

ICaptionServiceDescriptor::GetCaptionServiceNumber method (atscpsipparser.h)

  • Article

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

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.

The GetCaptionServiceNumber method returns the service number within the closed captioning stream for a specified caption service.

Syntax

HRESULT GetCaptionServiceNumber(
  [in]  BYTE bIndex,
  [out] BYTE *pbVal
);

Parameters

[in] bIndex

Zero-based index of the caption service. To get the number of caption services, call ICaptionServiceDescriptor::GetNumberOfServices.

[out] pbVal

Receives the caption_service_number field.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
MPEG2_E_INCORRECT_DESCRIPTOR_TAG
 The table descriptor tag is incorrect.
MPEG2_E_MALFORMED_TABLE
 The PSIP table is not well formed.
MPEG2_E_OUT_OF_BOUNDS
 The bIndex parameter is out of range.

Requirements

Requirement Value
Target Platform Windows
Header atscpsipparser.h

See also

ICaptionServiceDescriptor Interface