Share via

IDvbServiceDescriptor::GetServiceNameEmphasized

  • Article
 
Microsoft DirectShow 9.0

IDvbServiceDescriptor::GetServiceNameEmphasized

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

The GetServiceNameEmphasized method returns the emphasized version of the service name.

Syntax

  HRESULT GetServiceNameEmphasized(
  BSTR*  pbstrName
);

Parameters

pbstrName

[out]  Receives a BSTR that contains the service name. The caller must free the returned string by calling SysFreeString.

Return Values

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.

Remarks

This method converts the raw service name to Windows byte order, translates the string into the correct code page, and removes the control characters. Only characters marked as emphasized are copied into the string—that is, characters that occur between the emphasis-on and emphasis-off control codes. To get the full service name, call IDvbServiceDescriptor::GetProcessedServiceName.

For more information about character encoding in DVB Service Information (SI) descriptors, refer to ETSI 300 468, Appendix A.

Requirements

Header: Include dvbsiparser.h.

See Also