timeGetTime 関数 (timeapi.h)

  • [アーティクル]

timeGetTime 関数は、システム時刻をミリ秒単位で取得します。 システム時刻は、Windows が開始されてから経過した時間です。

構文

DWORD timeGetTime();

戻り値

システム時刻をミリ秒単位で返します。

注釈

この関数と timeGetSystemTime 関数の唯一の違いは、 timeGetSystemTime が MMTIME 構造体を使用してシステム時刻を返す点です。 timeGetTime 関数は、timeGetSystemTime よりもオーバーヘッドが少なくなります。

timeGetTime 関数によって返される値は DWORD 値であることに注意してください。 戻り値は 2^32 ミリ秒ごとに約 0 に折り返されます。これは約 49.71 日です。 これにより、計算で timeGetTime の戻り値を直接使用するコードで問題が発生する可能性があります。特に、コードの実行を制御するために値が使用されます。 計算では、常に 2 つの timeGetTime 戻り値の差を使用する必要があります。

timeGetTime 関数の既定の有効桁数は、コンピューターに応じて 5 ミリ秒以上にすることができます。 timeBeginPeriod 関数と timeEndPeriod 関数を使用して、timeGetTime の精度を高めることができます。 その場合、 timeGetTime によって返される連続する値の最小差は、 timeBeginPeriod と timeEndPeriod を使用して設定された最小期間の値と同じ大きさになります。 QueryPerformanceCounter 関数と QueryPerformanceFrequency 関数を使用して、短い時間間隔を高解像度で測定します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー timeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

マルチメディア タイマー関数

マルチメディア タイマー