The CRefTime class is used to manage reference times. It shares the same data layout as the REFERENCE_TIME data type, but adds some (nonvirtual) functions that provide simple comparison, conversion, and arithmetic capabilities.
A reference time is a unit of time represented in 100-nanosecond units. This time unit is the same time unit used by the Microsoft® Win32® FILETIME structure, although the two types cannot be interchanged. Note that the time a REFERENCE_TIME represents is not the time elapsed since 1/1/1601. It is either stream time or reference time, depending on the context.
m_time REFERENCE_TIME value of this object.
Member Functions
CRefTime Constructs a CRefTime object. GetUnits Returns the reference time in units of 100 nanoseconds. Millisecs Returns the reference time in milliseconds.
operator (REFERENCE_TIME) Casts the CRefTime object to a REFERENCE_TIME data type. The result is the m_time value. operator = Implements the copy constructor for the CRefTime class. operator += Adds two CRefTime objects and makes this object equal to the result. operator = Subtracts one CRefTime object from another CRefTime object and makes this object equal to the result.
Constructs a CRefTime object.
Syntax
CRefTime(void);
CRefTime(
LONG msecs
);
CRefTime(
REFERENCE_TIME rt
);
Parameters
Return Value
No return value.
Remarks
When constructed without parameters, the reference time value defaults to zero.
Retrieves the reference time in 100-nanosecond units.
Syntax
LONGLONG GetUnits(void);
Return Value
Returns the reference time value.
Returns the reference time in milliseconds.
Syntax
LONG Millisecs(void);
Return Value
Returns the reference time value.
Cast operator that enables a CRefTime object to be used in place of a REFERENCE_TIME object.
Syntax
operator REFERENCE_TIME() const;
Return Value
Returns the value of m_time.
Remarks
The following example shows how this cast operator can be used.
CRefTime cRT(1000); REFERENCE_TIME rt = (REFERENCE_TIME)cRT;
Assigns a new value to the object from an existing value.
Syntax
CRefTime& operator=(
const CRefTime& rt
);
CRefTime& operator=(
const LONGLONG ll
);
Parameters
- rt
- Object to copy during the assignment operation.
- ll
- LONGLONG reference time value.
Return Value
Returns a reference to this object after the operation.
Adds the value of another CRefTime object to this CRefTime object.
Syntax
CRefTime& operator+=(
const CRefTime& rt
);
Parameters
- rt
- CRefTime object to be added.
Return Value
Returns a reference to this object.
Subtracts another CRefTime object from this CRefTime object.
Syntax
CRefTime& operator-=(
const CRefTime& rt
);
Parameters
- rt
- CRefTime object to be subtracted.
Return Value
Returns the result.
Top of Page
© 2000 Microsoft and/or its suppliers. All rights reserved. Terms of Use.