Partager via

IGuideData::GetScheduleEntryProperties

  • Article
 
Microsoft DirectShow 9.0

IGuideData::GetScheduleEntryProperties

The GetScheduleEntryProperties method retrieves the properties for a specified schedule entry.

Syntax

  HRESULT GetScheduleEntryProperties(
  VARIANT  varScheduleEntryDescriptionID,
  IEnumGuideDataProperties**  ppEnumProperties
);

Parameters

varScheduleEntryDescriptionID

[in]  Specifies the unique identifier for the schedule entry. Call the IGuideData::GetScheduleEntryIDs method to get a list of schedule entry identifiers.

ppEnumProperties

[out]  Pointer to a variable that receives an IEnumGuideDataProperties interface pointer. Use this interface to enumerate the properties. The caller must release the interface

Return Values

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

Return code Description
S_OK The method succeeded.

Remarks

The returned collection includes the following properties.

Property Description
Description.ID The unique identifier for the schedule entry.
Time.Start The starting time and date of this schedule entry. The value of this property is an unsigned long containing the time and date in GPS time.
Time.End The ending time and date of this schedule entry. The value of this property is an unsigned long containing the time and date in GPS time.
ScheduleEntry.ProgramID Identifies the program that will play at the time specified by this schedule entry. The value of this property corresponds to the Description.ID property of the program.
ScheduleEntry.ServiceID Identifies the service that carries the program represented by this schedule entry. The value of this property corresponds to the Description.ID property of the service.

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

Requirements

  Header: Include bdatif.h.

See Also