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

ValueMin에서 ValueMax로 유효한 증분을 정의하는 단계별 델타를 수신하는 VARIANT 형식에 대한 포인터입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_NOTIMPL	속성은 선형 범위가 아닌 가능한 값 목록을 지원합니다.

매개 변수의 유효한 범위는 [ValueMax... ValueMax], SteppingDelta 증분 매개 변수가 단계별 값 범위를 지원하는 경우 다음 변형 형식 중 하나를 사용해야 합니다.

정의에 따라 매개 변수는 특정 형식을 반환합니다.

모든 단계별 값이 유효합니다. 범위에 단계별 델타가 없는 경우(즉, 모든 값으로 증분할 수 있음) 인코더는 SteppingDelta에 대해 빈 값(VT_EMPTY)을 반환해야 합니다.

Api가 ENCAPIPARAM_BITRATE_MODE 같으면 비트 전송률 모드 상수가 특정 값의 목록이므로 메서드는 E_NOTIMPL 반환합니다.