IDvbServiceDescriptor::GetServiceNameEmphasized Method

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(
  [out]  BSTR *pbstrName
);

Parameters

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

Return Value

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

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

See Also

IDvbServiceDescriptor Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008