COutputQueue.NewSegment-Methode

[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 NewSegment -Methode liefert ein neues Segment an den Eingabenadel.

Syntax

HRESULT NewSegment(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop,
   double         dRate
);

Parameter

tStart

Startmedienposition des Segments in 100 Nanosekundeneinheiten.

tStop

Endmedienposition des Segments in 100 Nanosekundeneinheiten.

dRate

Rate, mit der dieses Segment verarbeitet werden soll, als Prozentsatz des ursprünglichen Tarifs.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Wenn das Objekt einen Thread verwendet, werden die folgenden Elemente in der Reihenfolge in die Warteschlange eingereiht:

• Eine NEW_SEGMENT-Steuerelementmeldung.
• Die Segmentdaten.

Die NEW_SEGMENT Meldung benachrichtigt den Thread, dass das nächste Element in der Warteschlange Segmentdaten enthält. Die Segmentdaten werden in einer Struktur gebündelt, die wie folgt deklariert wird:

struct NewSegmentPacket {
    REFERENCE_TIME tStart;
    REFERENCE_TIME tStop;
    double dRate;
}; 

Der Thread ruft die IPin::NewSegment-Methode auf dem Eingabenadel unter Verwendung der in der -Struktur angegebenen Daten auf.

Wenn das Objekt keinen Thread verwendet, ruft es die COutputQueue::SendAnyway-Methode auf, um ausstehende Beispiele zu übermitteln. Anschließend wird IPin::NewSegment auf dem Eingabenadel aufgerufen.

Anforderungen

Siehe auch

COutputQueue-Klasse