CSourceStream-Klasse

[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 CSourceStream-Klasse stellt einen Ausgabepin für die CSource-Filterklasse bereit.

Informationen zur Verwendung dieser Klasse finden Sie unter CSource. Diese Klasse erbt die CAMThread-Klasse , die einen Workerthread zum Streamen von Daten vom Pin bereitstellt. Die CSourceStream-Klasse implementiert die folgenden Hilfsmethoden, um Anforderungen an den Thread zu senden:

• CSourceStream::Exit
• CSourceStream::Init
• CSourceStream::P ause
• CSourceStream::Run
• CSourceStream::Stop

Die erste Anforderung an den Thread muss Init sein. Die Exit-Anforderung beendet den Thread. In der Praxis ist es nicht notwendig, eine dieser Methoden direkt aufzurufen, da die Methoden CSourceStream::Active und CSourceStream::Inactive des Pins sie bei Bedarf aufrufen.

Die -Klasse stellt auch mehrere "Handler"-Methoden bereit:

• CSourceStream::OnThreadCreate
• CSourceStream::OnThreadDestroy
• CSourceStream::OnThreadStartPlay

Diese führen in der Basisklasse nichts aus, aber die abgeleitete Klasse kann sie überschreiben.

Geschützte Membervariablen	BESCHREIBUNG
m_pFilter	Zeiger auf den Filter, der diese Pin enthält.
Geschützte Methoden	BESCHREIBUNG
OnThreadCreate	Wird aufgerufen, wenn der Streamingthread initialisiert wird. Virtuellen.
OnThreadDestroy	Wird aufgerufen, wenn der Streamingthread beendet wird. Virtuellen.
OnThreadStartPlay	Wird am Anfang der CSourceStream::D oBufferProcessingLoop-Methode aufgerufen. Virtuellen.
Aktiv	Benachrichtigt den Pin, dass der Filter jetzt aktiv ist.
Inaktiv	Benachrichtigt den Pin, dass der Filter nicht mehr aktiv ist.
GetRequest	Wartet auf die nächste Threadanforderung.
CheckRequest	Überprüft, ob eine Threadanforderung vorhanden ist, ohne zu blockieren.
ThreadProc	Threadprozedur. Virtuellen.
DoBufferProcessingLoop	Generiert Mediendaten und übermittelt sie an den Downstreameingabe-Pin. Virtuellen.
CheckMediaType	Bestimmt, ob die Pin einen bestimmten Medientyp akzeptiert. Virtuellen.
GetMediaType	Ruft einen bevorzugten Medientyp ab. Virtuellen.
Öffentliche Methoden	BESCHREIBUNG
CSourceStream	Konstruktormethode.
~ CSourceStream	Destruktormethode. Virtuellen.
Init	Initialisiert den Streamingthread.
Beenden	Signalisiert, dass der Streamingthread beendet wird.
Ausführung	Signalisiert die Ausführung des Streamingthreads.
Anhalten	Signalisiert, dass der Streamingthread aktiv wird.
Beenden	Signalisiert, dass der Streamingthread beendet wird.
Reine virtuelle Methoden	BESCHREIBUNG
FillBuffer	Füllt ein Medienbeispiel mit Daten.
IPin-Methoden	BESCHREIBUNG
QueryId	Ruft einen Bezeichner für den Pin ab.

Anforderungen

Anforderung	Wert
Header	Source.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

Schreiben von Quellfiltern