Partager via


Fonction MFScheduleWorkItem (mfapi.h)

Planifie une opération asynchrone à effectuer après un intervalle spécifié.

Syntaxe

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

Paramètres

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback . L’appelant doit implémenter cette interface.

[in] pState

Pointeur vers l’interface IUnknown d’un objet d’état, défini par l’appelant. Ce paramètre peut être NULL. Vous pouvez utiliser cet objet pour stocker des informations d’état. L’objet est retourné à l’appelant lorsque le rappel est appelé.

[in] Timeout

Intervalle de délai d’attente, en millisecondes. Définissez ce paramètre sur une valeur négative. Le rappel est appelé après −Délai d’attente en millisecondes. Par exemple, si le délai d’expiration est de −5000, le rappel est appelé après 5 000 millisecondes.

[out] pKey

Reçoit une clé qui peut être utilisée pour annuler le minuteur. Pour annuler le minuteur, appelez MFCancelWorkItem et passez cette clé dans le paramètre Key .

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
La fonction a réussi.

Remarques

Cette fonction crée un objet de résultat asynchrone. Lorsque l’intervalle du minuteur s’écoule, la méthode IMFAsyncCallback ::Invoke spécifiée par pCallback est appelée.

Cette fonction est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfapi.h
Bibliothèque Mfplat.lib
DLL Mfplat.dll

Voir aussi

MFScheduleWorkItemEx

Fonctions Media Foundation

Files d’attente de travail