IKsPin::KsDeliver 方法 (ksproxy.h)
KsDeliver 方法會將媒體範例從輸出針腳傳遞至輸入針腳、從配置器擷取下一個緩衝區,並將緩衝區提交至相關聯的裝置,以繼續 I/O 作業。
語法
HRESULT KsDeliver(
[in] IMediaSample *Sample,
[in] ULONG Flags
);
參數
[in] Sample
相關聯媒體範例的 IMediaSample 介面指標。
[in] Flags
指定位掩碼,列舉媒體範例之數據流標頭的相關信息。 可以有下列旗標的位 OR 組合:
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
這些旗標定義於 KSSTREAM_HEADER 結構描述的OptionsFlags成員中。
針腳聯機會檢查數據流結尾旗標 (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM) ,以判斷它是否必須在範例完成之後傳遞數據流結束事件。
傳回值
如果成功,則傳回 NOERROR;否則,傳回錯誤碼。
備註
介面處理程式 (IKsInterfaceHandler) 在篩選的輸出針腳上呼叫 KsDeliver ,將媒體範例傳遞給另一個篩選的輸入針腳。 這些輸入和輸出針腳已連接。
對於輸入針腳, KsDeliver 是無效的進入點,並傳回EFAIL。
如需 IMediaSample 的詳細資訊,請參閱 Microsoft Windows SDK 檔。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | ksproxy.h (包含 Ksproxy.h) |