共用方式為

啟動單一定時器事件

  • 發行項

[與此頁面相關聯的功能 多媒體定時器是舊版功能。 多媒體類別排程器服務已取代它。 多媒體類別排程器服務 已針對 Windows 10 和 Windows 11 優化。 Microsoft強烈建議新程式代碼盡可能使用 多媒體類別排程器服務，而不是 多媒體定時器。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]

注意

本主題描述過時的函式。 新的應用程式應該使用 CreateTimerQueueTimer 函式來建立定時器。

 

若要啟動單一定時器事件，請呼叫 timeSetEvent 函式，並指定回呼發生前的時間量、解析、回呼函式的位址（請參閱 TimeProc），以及用戶數據來提供回呼函式。 應用程式可以使用類似下列的函式來啟動單一定時器事件。

UINT SetTimerCallback(NPSEQ npSeq,  // sequencer data
    UINT msInterval)                // event interval
{ 
    npSeq->wTimerID = timeSetEvent(
        msInterval,                    // delay
        wTimerRes,                     // resolution (global variable)
        OneShotCallback,               // callback function
        (DWORD)npSeq,                  // user data
        TIME_ONESHOT );                // single timer event
    if(! npSeq->wTimerID)
        return ERR_TIMER;
    else
        return ERR_NOERROR;
}

如需回呼函式 OneShotCallback 的範例，請參閱 撰寫定時器回呼函式。

使用多媒體定時器