MFScheduleWorkItem 函式 (mfapi.h)
排程在指定間隔之後要完成的異步操作。
語法
HRESULT MFScheduleWorkItem(
[in] IMFAsyncCallback *pCallback,
[in] IUnknown *pState,
[in] INT64 Timeout,
[out] MFWORKITEM_KEY *pKey
);
參數
[in] pCallback
IMFAsyncCallback 介面的指標。 呼叫端必須實作這個介面。
[in] pState
狀態物件的 IUnknown 介面指標,由呼叫端定義。 此參數可以是 Null。 您可以使用這個物件來儲存狀態資訊。 叫用回呼時,物件會傳回給呼叫端。
[in] Timeout
超時時間間隔,以毫秒為單位。 將此參數設定為負值。 回呼會在 -Timeout 毫秒之後叫用。 例如,如果 Timeout 為 -5000,則會在 5000 毫秒之後叫用回呼。
[out] pKey
接收可用來取消定時器的金鑰。 若要取消定時器,請呼叫 MFCancelWorkItem ,並在 Key 參數中傳遞此 密鑰 。
傳回值
函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此函數已成功。 |
備註
此函式會建立異步結果物件。 定時器間隔經過時,會呼叫 pCallback 所指定的 IMFAsyncCallback::Invoke 方法。
如果已安裝 Windows Media Format 11 SDK 可轉散發元件,此函式可在下列平臺上使用:
- Windows XP with Service Pack 2 (SP2) 和更新版本。
- 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月更新匯總) 的 Windows XP Media Center Edition 2005。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mfapi.h |
程式庫 | Mfplat.lib |
Dll | Mfplat.dll |