IDistributorNotify::NotifyGraphChange-Methode (strmif.h)

[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 NotifyGraphChange -Methode wird aufgerufen, wenn sich der Satz von Filtern im Filterdiagramm ändert oder sich pin-Verbindungen ändern.

Syntax

HRESULT NotifyGraphChange();

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Diese Methode wird immer dann aufgerufen, wenn die IFilterGraph::AddFilter-, IFilterGraph::RemoveFilter- oder IFilterGraph::ConnectDirect-Methode aufgerufen wird oder eine Methode aufgerufen wird, die dazu führt, dass eine dieser Methoden aufgerufen wird (z. B. IGraphBuilder::RenderFile).

Stellen Sie sicher, dass Sie Release für alle gehaltenen Filter aufrufen, die an diesem Punkt entfernt wurden. Aus Leistungsgründen können PIDs die Filter nicht erneut scannen, bis die PIDs die Schnittstellen tatsächlich benötigen, da möglicherweise mehrere separate Benachrichtigungen gesendet werden. Es ist jedoch wichtig, alle zwischengespeicherten Schnittstellen sofort freizugeben.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IDistributorNotify-Schnittstelle