IMediaEvent::FreeEventParams-Methode (control.h)

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die FreeEventParams -Methode gibt Ressourcen frei, die den Parametern eines Ereignisses zugeordnet sind.

Syntax

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

Parameter

[in] lEvCode

Ereigniscode.

[in] lParam1

Erster Ereignisparameter.

[in] lParam2

Zweiter Ereignisparameter.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Nachdem Sie die IMediaEvent::GetEvent-Methode zum Abrufen einer Ereignisbenachrichtigung aufgerufen haben, müssen Sie aufrufen FreeEventParams. Diese Methode gibt alle Ressourcen frei, die für die Ereignisparameter zugeordnet wurden. Übergeben Sie die gleichen Variablen, die für den GetEvent-Aufruf verwendet werden.

Beispiele


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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	control.h (include Dshow.h)
Bibliothek	Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IMediaEvent-Schnittstelle

IMediaEventEx

Freigeben über