次の方法で共有


IGuideData::GetServices method (bdatif.h)

[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 GetServices method retrieves a collection of tune requests representing all the services available in the tuning space.

Syntax

HRESULT GetServices(
  [out] IEnumTuneRequests **ppEnumTuneRequests
);

Parameters

[out] ppEnumTuneRequests

Pointer to a variable that receives an IEnumTuneRequests interface pointer. Use this interface to enumerate the properties. The caller must release the interface.

Return value

The method returns an HRESULT. Possible values include those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

This method is used to enumerate all services listed in the service descriptor table. Each tune request in the returned collection contains locator data for the service. To get more information about a service, pass the ITuneRequest pointer to the IGuideData::GetServiceProperties method.

The method fails if the TIF has not received the service information from the PSI tables in the transport stream. The client should implement the IGuideDataEvent interface and wait for the IGuideDataEvent::ServiceChanged event to be fired.

Requirements

Requirement Value
Target Platform Windows
Header bdatif.h

See also

Error and Success Codes

IGuideData Interface