Поделиться через

Метод IEncoderAPI::GetParameterRange (strmif.h)

  • Статья

[Функция, связанная с этой страницей, Microsoft TV Technologies, является устаревшей функцией. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код не использовал эту функцию.]

[IEncoderAPI больше недоступен для использования. Вместо этого используйте ICodecAPI.]

Метод GetParameterRange извлекает допустимый диапазон значений, поддерживаемых параметром, в случаях, когда параметр поддерживает ступенчатый диапазон, а не список конкретных значений.

Синтаксис

HRESULT GetParameterRange(
  [in]  const GUID *Api,
  [out] VARIANT    *ValueMin,
  [out] VARIANT    *ValueMax,
  [out] VARIANT    *SteppingDelta
);

Параметры

[in] Api

Указатель на GUID, указывающий параметр .

[out] ValueMin

Указатель на тип VARIANT , получающий минимальное значение параметра.

[out] ValueMax

Указатель на тип VARIANT , получающий максимальное значение параметра.

[out] SteppingDelta

Указатель на тип VARIANT , который получает разностную пошаговую разницу, которая определяет допустимые приращения от ValueMin к ValueMax.

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_NOTIMPL
 Свойство поддерживает список возможных значений, а не линейный диапазон.

Комментарии

Допустимый диапазон для параметра — [ValueMax... ValueMax], с приращением SteppingDelta. Если параметр поддерживает ступенчатый диапазон значений, он должен использовать один из следующих типов вариантов:

  • Типы без знака: VT_UI8, VT_UI4, VT_UI2, VT_UI1
  • Типы подписи: VT_I8, VT_I4, VT_I2
  • Типы float: VT_R8, VT_R4
По определению параметр возвращает определенный тип.

Допустимо любое пошаговое значение. Если диапазон не имеет пошаговой разницы (то есть можно увеличить на любое значение), кодировщик должен вернуть пустое значение (VT_EMPTY) для SteppingDelta.

Если API равен ENCAPIPARAM_BITRATE_MODE, метод возвращает E_NOTIMPL, так как константы режима скорости представляют собой список определенных значений.

Требования

Требование Значение
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

API кодировщика

Интерфейс IEncoderAPI