IKsPin::KsDeliver-Methode (ksproxy.h)
Die KsDeliver--Methode liefert ein Medienbeispiel von einer Ausgabenadel an einen Eingabenadel, setzt einen E/A-Vorgang fort, indem der nächste Puffer von einem Allocator abgerufen und der Puffer an das zugeordnete Gerät übermittelt wird.
Syntax
HRESULT KsDeliver(
[in] IMediaSample *Sample,
[in] ULONG Flags
);
Parameter
[in] Sample
Zeiger auf die IMediaSample Schnittstelle für das zugeordnete Medienbeispiel.
[in] Flags
Gibt eine Bitmaske an, die Informationen zum Datenstromheader des Medienbeispiels aufzählt. Eine bitweise OR-Kombination der folgenden Flags ist möglich:
KSSTREAM_HEADER_OPTIONSF_SPLICEPOINT
KSSTREAM_HEADER_OPTIONSF_PREROLL
KSSTREAM_HEADER_OPTIONSF_DATADISCONTINUITY
KSSTREAM_HEADER_OPTIONSF_TYPECHANGED
KSSTREAM_HEADER_OPTIONSF_TIMEVALID
KSSTREAM_HEADER_OPTIONSF_TIMEDISCONTINUITY
KSSTREAM_HEADER_OPTIONSF_FLUSHONPAUSE
KSSTREAM_HEADER_OPTIONSF_DURATIONVALID
KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM
KSSTREAM_HEADER_OPTIONSF_LOOPEDDATA
Diese Flags werden im OptionsFlags Element der KSSTREAM_HEADER Strukturbeschreibung definiert.
Die Pinverbindung überprüft das End-of-Stream-Flag (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM), um festzustellen, ob nach Abschluss des Beispiels ein End-of-Stream-Ereignis übergeben werden muss.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.
Bemerkungen
Ein Schnittstellenhandler (IKsInterfaceHandler) ruft KsDeliver auf den Ausgabestift eines Filters auf, um ein Medienbeispiel an den Eingabenadel eines anderen Filters zu übermitteln. Diese Eingabe- und Ausgabe-Pins sind verbunden.
Für einen Eingabenadel ist KsDeliver ein ungültiger Einstiegspunkt und gibt EFAIL zurück.
Weitere Informationen zu IMediaSamplefinden Sie in der Microsoft Windows SDK-Dokumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | ksproxy.h (include Ksproxy.h) |