Метод IKsPin::KsDeliver (ksproxy.h)
Метод KsDeliver предоставляет образец носителя из выходного пин-кода на входной пин-код, продолжает операцию ввода-вывода, извлекая следующий буфер из распределителя и отправляет буфер на связанное устройство.
Синтаксис
HRESULT KsDeliver(
[in] IMediaSample *Sample,
[in] ULONG Flags
);
Параметры
[in] Sample
Указатель на интерфейс IMediaSample для связанного примера мультимедиа.
[in] Flags
Указывает битовую маску, перечисляющую сведения о заголовке потока образца мультимедиа. Побитовая комбинация ИЛИ следующих флагов возможна:
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
Эти флаги определены в элементе OptionsFlags описания структуры KSSTREAM_HEADER.
Закрепление подключения проверяет наличие флага конца потока (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM), чтобы определить, должно ли оно доставлять событие конца потока после завершения примера.
Возвращаемое значение
Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.
Замечания
Обработчик интерфейса (IKsInterfaceHandler) вызывает KsDeliver на выходной пин-код фильтра для доставки образца носителя в входной пин-код другого фильтра. Эти входные и выходные контакты подключены.
Для входного пин-кода KsDeliver является недопустимой точкой входа и возвращает EFAIL.
Дополнительные сведения о IMediaSampleсм. в документации по пакету SDK для Microsoft Windows.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | ksproxy.h (включая Ksproxy.h) |