IMediaEvent::FreeEventParams, méthode (control.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La FreeEventParams méthode libère les ressources associées aux paramètres d’un événement.

Syntaxe

HRESULT FreeEventParams(
  [in] long     lEvCode,
  [in] LONG_PTR lParam1,
  [in] LONG_PTR lParam2
);

Paramètres

[in] lEvCode

Code d’événement.

[in] lParam1

Premier paramètre d’événement.

[in] lParam2

Deuxième paramètre d’événement.

Valeur renvoyée

Retourne S_OK.

Notes

Après avoir appelé la méthode IMediaEvent::GetEvent pour récupérer une notification d’événement, vous devez appeler FreeEventParams. Cette méthode libère toutes les ressources qui ont été allouées pour les paramètres d’événement. Transmettez les mêmes variables que celles utilisées pour l’appel GetEvent .

Exemples


hr = pEvent->GetEvent(&evCode, &param1, &param2, 0);
// Handle the event (not shown). 
hr = pEvent->FreeEventParams(evCode, param1, param2);

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	control.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

IMediaEvent Interface

IMediaEventEx

Partager via