IMFMediaEventQueue ::QueueEventParamVar, méthode (mfobjects.h)

Article
03/02/2024

Crée un événement, définit un PROPVARIANT comme données d’événement et place l’événement dans la file d’attente.

Appelez cette méthode dans votre implémentation de IMFMediaEventGenerator ::QueueEvent. Passez les paramètres de cette méthode directement à cette méthode.

Vous pouvez également appeler cette méthode lorsque votre composant doit déclencher un événement qui ne contient pas d’attributs. Si les données d’événement sont un pointeur IUnknown , vous pouvez utiliser IMFMediaEventQueue ::QueueEventParamUnk. Si l’événement contient des attributs, utilisez PLUTÔT IMFMediaEventQueue ::QueueEvent .

Syntaxe

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

Paramètres

[in] met

Spécifie le type de l’événement à ajouter à la file d’attente. Le type d’événement est retourné par la méthode IMFMediaEvent ::GetType de l’événement . Pour obtenir la liste des types d’événements, consultez Événements Media Foundation.

[in] guidExtendedType

Type étendu de l’événement. Si l’événement n’a pas de type étendu, utilisez la valeur GUID_NULL. Le type étendu est retourné par la méthode IMFMediaEvent ::GetExtendedType de l’événement .

[in] hrStatus

Code de réussite ou d’échec indiquant la status de l’événement. Cette valeur est retournée par la méthode IMFMediaEvent ::GetStatus de l’événement.

[in] pvValue

Pointeur vers un PROPVARIANT qui contient la valeur d’événement. Ce paramètre peut être NULL. Cette valeur est retournée par la méthode IMFMediaEvent ::GetValue de l’événement.

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	La méthode Shutdown a été appelée.

Remarques

Cette interface 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 \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfobjects.h (include Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

IMFMediaEventQueue

Partager via