Метод IMFMediaSink::GetCharacteristics (mfidl.h)

  • Статья

Возвращает характеристики приемника мультимедиа.

Синтаксис

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Параметры

[out] pdwCharacteristics

Получает побитовое ЗНАЧЕНИЕ ИЛИ , равное нулю или более флагам. Определены следующие флаги:

Значение Значение
MEDIASINK_FIXED_STREAMS
0x00000001
 Приемник мультимедиа имеет фиксированное количество потоков. Он не поддерживает методы IMFMediaSink::AddStreamSink и IMFMediaSink::RemoveStreamSink . Этот флаг является подсказкой для приложения.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 Приемник мультимедиа не может соответствовать скоростям с внешними часами.

Для достижения наилучших результатов этот приемник мультимедиа следует использовать в качестве источника времени для часов презентации. Если используется какой-либо другой источник времени, приемник мультимедиа не может сопоставить скорость с часами с плохими результатами (например, сбоем).

Этот флаг следует использовать редко, так как он ограничивает настройку конвейера.

Дополнительные сведения о часах презентации см. в разделе Presentation Clock.
MEDIASINK_RATELESS
0x00000004
 Приемник мультимедиа является неустанным. Он использует образцы как можно быстрее и не синхронизируется с часами презентации.

Большинство приемников архивации являются неустанными.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 Для приемника мультимедиа требуются часы презентации. Часы представления задаются путем вызова метода IMFMediaSink::SetPresentationClock приемника мультимедиа.

Этот флаг устарел, так как все приемники мультимедиа должны поддерживать метод SetPresentationClock , даже если приемник мультимедиа игнорирует часы (как в приемнике мультимедиа без скорости).
MEDIASINK_CAN_PREROLL
0x00000010
 Приемник мультимедиа может принимать предварительные примеры до запуска часов презентации. Приемник средств массовой информации раскрывает интерфейс IMFMediaSinkPreroll .
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 Первый приемник потока (индекс 0) является ссылочным потоком. Ссылочный поток должен иметь тип носителя, прежде чем типы мультимедиа можно будет задать в других приемниках потоков.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
MF_E_SHUTDOWN
 Был вызван метод Shutdown приемника мультимедиа.

Комментарии

Характеристики приемника носителя фиксируются на протяжении всего времени существования приемника.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfidl.h
Библиотека Mfuuid.lib

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

IMFMediaSink

Приемники мультимедиа