This 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.
Data Members
Name | Description |
m_time | REFERENCE_TIME value of this object. |
Member Functions
Name | Description |
CRefTime | Constructs a CRefTime object. |
GetUnits | Returns the reference time in units of 100 nanoseconds. |
Millisecs | Returns the reference time in milliseconds. |
Operators
Name | Description |
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.
CRefTime( );
CRefTime(
LONG msecs
);
CRefTime(
REFERENCE_TIME rt
);
No return value.
When constructed without parameters, the reference time value defaults to zero.
Returns the reference time in 100-nanosecond units.
LONGLONG GetUnits(void);
Returns the reference time value.
Returns the reference time in milliseconds.
LONG Millisecs(void);
Returns the reference time value.
Cast operator that allows a CRefTime object to be used in place of a REFERENCE_TIME object.
operator REFERENCE_TIME() const;
Returns the value of m_time.
The following examples show 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.
CRefTime& operator=(
const CRefTime& rt
);
CRefTime& operator=(
const LONGLONG ll
);
Returns a reference to this object after the operation.
Adds the value of another CRefTime object to this CRefTime object.
CRefTime& operator+=(
const CRefTime& rt
);
Returns a reference to this object.
Subtracts another CRefTime object from this CRefTime object.
CRefTime& operator-=(
const CRefTime& rt
);
Returns the result.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.