Метод ICodecAPI::GetParameterRange (icodecapi.h)

Метод GetParameterRange получает диапазон значений для свойства кодека.

Этот метод применяется только к свойствам, значения которых образуют линейный диапазон.

Синтаксис

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

Параметры

[in] Api

Указатель на GUID, указывающий свойство для запроса. Список стандартных свойств кодека см. в разделе Свойства API кодека.

[out] ValueMin

Указатель на VARIANT , получающий минимальное значение свойства. Вызывающий объект должен освободить variant , вызвав VariantClear.

ValueMax

[out] SteppingDelta

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

Если тип VARIANT — VT_EMPTY, то допустимы любые приращения.

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

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

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

Комментарии

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

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

Если свойство поддерживает список значений, а не диапазон, метод возвращает VFW_E_CODECAPI_ENUMERATED. В этом случае вызовите метод ICodecAPI::GetParameterValues , чтобы получить список значений.

Требования

Минимальная версия клиента	Сборка Windows 10 20348
Минимальная версия сервера	Сборка Windows 10 20348
Верхняя часть	icodecapi.h

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

Справочник по API кодека

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

ICodecAPI