COutputQueue.ReceiveMultiple-Methode

  • Artikel

[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 ReceiveMultiple -Methode liefert einen Batch von Medienbeispielen an den Eingabenadel.

Syntax

HRESULT ReceiveMultiple(
   IMediaSample **ppSamples,
   long         nSamples,
   long         *nSamplesProcessed
);

Parameter

ppSamples

Adresse eines Zeigers auf ein Array von Beispielen.

nSamples

Anzahl der Stichproben im Array.

nSamplesProcessed

Zeiger auf eine Variable, die die Anzahl der erfolgreich übermittelten Beispiele empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Rückgabecode Beschreibung
S_FALSE
 Benachrichtigung zum Datenstromende, die vor der Verarbeitung dieses Beispiels empfangen wurde.
S_OK
 Erfolg.

Bemerkungen

Wenn das Objekt einen Thread verwendet, werden mit dieser Methode alle im Array übergebenen Beispiele in die Warteschlange eingereiht. Andernfalls ruft die Methode die IMemInputPin::ReceiveMultiple-Methode auf dem Eingabepin auf.

Anforderungen

Anforderung Wert
Header
Outputq.h (Streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

COutputQueue-Klasse