Метод IKsInterfaceHandler::KsCompleteIo (ksproxy.h)

Статья
02/07/2025

Метод KsCompleteIo очищает расширенные заголовки и освобождает образцы мультимедиа после завершения ввода-вывода (ввода-вывода).

Синтаксис

HRESULT KsCompleteIo(
  [in, out] PKSSTREAM_SEGMENT StreamSegment
);

Параметры

[in, out] StreamSegment

Указатель на структуру KSSTREAM_SEGMENT, содержащую сведения о заголовке для завершения сегмента потока.

Возвращаемое значение

Возвращает NOERROR в случае успешного выполнения; в противном случае возвращает код ошибки.

Замечания

Метод KsCompleteIo удаляет выделенную память, обновляет примеры носителей и уменьшает количество элементов ожидания для прокси-сервера.

Метод KsCompleteIo должен определить тип операции ввода-вывода, завершенной методом IKsInterfaceHandler::KsProcessMediaSamples из элемента IoOperation элемента структуры KSSTREAM_SEGMENT. Если операция ввода-вывода считывала данные из потока (KsIoOperation_Read перечисленного типа KSIOOPERATION), KsCompleteIo выполняет следующие действия для доставки примера из выходного пин-кода на подключенный входной пин-код:

Отражает сведения о заголовке потока в интерфейсе IMediaSample.
Вызывает метод IKsPin::KsDeliver выходного закрепления для доставки примера. KsDeliver освобождает образец таким образом, чтобы при очередях буферов на устройство можно получить образец, если это последний пример. После этого входной пин-код завершает ввод-вывод и безопасно освободить пример.

Дополнительные сведения о IMediaSampleсм. в документации по пакету SDK для Microsoft Windows.