Freigeben über


EC_NEED_RESTART

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Ein Filter fordert einen Neustart des Diagramms an.

Parameter

lParam1

Keinen.

lParam2

Keinen.

Standardaktion

Der Filterdiagramm-Manager hält an und startet das Diagramm neu. Das Ereignis wird nicht an die Anwendung übergeben.

Bemerkungen

Wenn ein Filter ein Beispiel in der Mitte eines Datenstroms ablehnt, wird die Upstream Pin keine Beispiele mehr liefern. Der Filter kann den Stream durch Senden dieses Ereignisses neu starten. Beispielsweise kann der Audiorenderer den Zugriff auf das Soundgerät verlieren, da ein Videofenster den Fokus verloren hat. An diesem Punkt beginnt der Audiorenderer mit dem Ablehnen von Beispielen. Wenn der Zugriff auf das Soundgerät wiedererlangt wird, wird dieses Ereignis gesendet, um den Audiodatenstrom neu zu starten.

Anforderungen

Anforderung Wert
Header
Dshow.h

Siehe auch

Ereignisbenachrichtigungscodes

Ereignisbenachrichtigung in DirectShow