Freigeben über


CPullPin.Seek-Methode

[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.]

Die Seek -Methode legt die Start- und Stopppositionen des Streams fest.

Syntax

HRESULT Seek(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop
);

Parameter

tStart

Gibt die Startposition in Bytes multipliziert mit 10.000.000 an.

tStop

Gibt die Stoppposition in Bytes multipliziert mit 10.000.000 an.

Rückgabewert

Gibt S_OK zurück, wenn die Methode erfolgreich ist, oder andernfalls einen Fehlercode.

Bemerkungen

Wenn der Workerthread ausgeführt wird, hält die Methode den Thread an, löscht das Filterdiagramm und setzt den Thread fort. Der Thread beginnt mit dem Pullen von Daten von der neuen Startposition. Andernfalls werden die neuen Positionswerte beim Starten des Threads wirksam.

Positionen sind relativ zum Anfang der ursprünglichen Quelle. Multiplizieren Sie die gewünschten Byteoffsets mit der Konstante UNITS, die in der Basisklassenbibliothek als 10.000.000 definiert ist.

Wenn der Pin zum ersten Mal eine Verbindung herstellt, werden die Stopp- und Startpositionen standardmäßig am Anfang und Ende des Datenstroms angezeigt.

Anforderungen

Anforderung Wert
Header
Pullpin.h
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CPullPin-Klasse