Méthode IMFMediaEventQueue ::QueueEventParamUnk (mfobjects.h)

Article
03/01/2024

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

Syntaxe

HRESULT QueueEventParamUnk(
  [in] MediaEventType met,
  [in] REFGUID        guidExtendedType,
  [in] HRESULT        hrStatus,
  [in] IUnknown       *pUnk
);

Paramètres

[in] met

Spécifie le type d’événement 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 le status de l’événement. Cette valeur est retournée par la méthode IMFMediaEvent ::GetStatus de l’événement.

[in] pUnk

Pointeur vers l’interface IUnknown . La méthode définit ce pointeur comme valeur d’événement. Le pointeur est retourné 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

Appelez cette méthode lorsque votre composant doit déclencher un événement qui contient une valeur de pointeur IUnknown et aucun attribut. Si l’événement contient des attributs, utilisez IMFMediaEventQueue ::QueueEvent à la place.

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 Édition Media Center) 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 (inclure Mfidl.h)
Bibliothèque	Mfuuid.lib

Voir aussi

IMFMediaEventQueue

Partager via