Метод IKsDataTypeCompletion::KsCompleteMediaType (ksproxy.h)

Метод KsCompleteMediaType завершает частично указанный тип мультимедиа, который был впервые представлен методу IAMStreamConfig::SetFormat .

Синтаксис

HRESULT KsCompleteMediaType(
  [in]      HANDLE        FilterHandle,
  [in]      ULONG         PinFactoryId,
  [in, out] AM_MEDIA_TYPE *AmMediaType
);

Параметры

[in] FilterHandle

Дескриптор базового фильтра KS.

[in] PinFactoryId

Идентификатор фабрики контактов, для которой выполняется заполнение типа мультимедиа.

[in, out] AmMediaType

Указатель на структуру AM_MEDIA_TYPE, описывающую формат примеров мультимедиа. KsCompleteMediaType получает частично указанные примеры мультимедиа, завершает спецификацию и возвращает данные.

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

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

Комментарии

Метод KsCompleteMediaType в основном используется для видеофайлов, в которых элемент biSizeImageструктуры KS_BITMAPINFOHEADER известен только драйверу из-за поддерживаемых форматов закрытого сжатия. При необходимости обработчик типов данных может запросить базовый фильтр KS для завершения заданного типа мультимедиа.

Когда прокси-сервер создает экземпляр обработчика типа данных для завершения типа мультимедиа, прокси-сервер передает тип мультимедиа методу IKsDataTypeHandler::KsSetMediaType, чтобы сначала инициализировать этот обработчик типа данных для конкретного типа мультимедиа.

Дополнительные сведения об IAMStreamConfig::SetFormat и AM_MEDIA_TYPE см. в документации по Microsoft Windows SDK.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ksproxy.h (включая Ksproxy.h)

См. также раздел

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER