Méthode IMFTimer::SetTimer (mfidl.h)

Article
08/24/2023

Définit un minuteur qui appelle un rappel à l’heure spécifiée.

Syntaxe

HRESULT SetTimer(
  [in]  DWORD            dwFlags,
  [in]  LONGLONG         llClockTime,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState,
  [out] IUnknown         **ppunkKey
);

Paramètres

[in] dwFlags

OR au niveau du bit de zéro ou plusieurs indicateurs de l’énumération MFTIMER_FLAGS .

[in] llClockTime

Heure à laquelle le minuteur doit se déclencher, en unités de la fréquence de l’horloge. L’heure est absolue ou relative à l’heure actuelle, selon la valeur de dwFlags.

[in] pCallback

Pointeur vers l’interface IMFAsyncCallback d’un objet de rappel. L’appelant doit implémenter cette interface. La méthode Invoke du rappel est appelée à l’heure spécifiée dans le paramètre llClockTime .

[in] punkState

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é.

[out] ppunkKey

Reçoit un pointeur vers l’interface IUnknown d’un objet d’annulation. L’appelant doit libérer l’interface. Pour annuler le minuteur, passez ce pointeur à la méthode IMFTimer::CancelTimer . Ce paramètre peut être NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_SHUTDOWN	L’horloge a été arrêtée.
MF_S_CLOCK_STOPPED	La méthode a réussi, mais l’horloge est arrêtée.

Notes

Si l’horloge est arrêtée, la méthode retourne MF_S_CLOCK_STOPPED. Le rappel n’est pas appelé tant que l’horloge n’est pas démarrée.

Configuration requise


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	mfidl.h
Bibliothèque	Mfuuid.lib

Voir aussi

IMFTimer

Partager via