IDvbServiceDescriptor::GetServiceName

 
Microsoft DirectShow 9.0

IDvbServiceDescriptor::GetServiceName

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

The GetServiceName method returns the raw service name.

Syntax

  HRESULT GetServiceName(
  char**  pszName
);

Parameters

pszName

[out]  Receives a pointer to a null-terminated string that contains the service name.  The caller must free the returned string by calling CoTaskMemFree.

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 does not process the service name field, so the returned string is in the original byte order, with all of the control codes. To get the service name in readable form, 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