Метод 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) |