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

Siehe auch

IKsInterfaceHandler-

IKsInterfaceHandler::KsCompleteIo