IKsPin::KsDeliver-Methode (ksproxy.h)
Die KsDeliver-Methode übermittelt ein Medienbeispiel von einem Ausgabepin an einen Eingabenadel, setzt einen E/A-Vorgang fort, indem der nächste Puffer von einem Zuteilungsgeber abgerufen wird, und sendet den Puffer an das zugeordnete Gerät.
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 Streamheader 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 sind im OptionsFlags-Member der KSSTREAM_HEADER Strukturbeschreibung definiert.
Die Anheftverbindung überprüft das Streamendeflag (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM), um zu ermitteln, ob nach Abschluss des Beispiels ein Streamendeereignis übermittelt werden muss.
Rückgabewert
Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.
Hinweise
Ein Schnittstellenhandler (IKsInterfaceHandler) ruft KsDeliver auf dem Ausgabepin eines Filters auf, um ein Medienbeispiel an den Eingabepin eines anderen Filters zu übermitteln. Diese Eingabe- und Ausgabepins sind verbunden.
Bei einem Eingabenadel ist KsDeliver ein ungültiger Einstiegspunkt und gibt EFAIL zurück.
Weitere Informationen zu IMediaSample finden Sie in der Microsoft Windows SDK-Dokumentation.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | ksproxy.h (include Ksproxy.h) |