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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此函數已成功。

備註

此函式會建立異步結果物件。 定時器間隔經過時，會呼叫 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

另請參閱

MFScheduleWorkItemEx

媒體基礎函式

工作佇列