Microsoft DirectX 8.1 (C++)

IObjects::get_ItemsInTimeRange

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_ItemsInTimeRange method retrieves a collection of objects whose start or end times occur within the specified range.

Syntax

HRESULT get_ItemsInTimeRange(
  DATE  dtStart,
  DATE  dtEnd,
  IObjects**  ppVal
);

Parameters

dtStart

[in]  Specifies the start time of the range.

dtEnd

[in]  Specifies the end time of the range.

ppVal

[out]  Address of a variable to receive a pointer to the IObjects interface of the retrieved collection.

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.
E_OUTOFMEMORY There is not sufficient memory to create the collection.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

Items must overlap the specified range. For example, if the end time of an object is exactly the same as dtStart, the object is not included in the retrieved collection.

See Also