DirectShow DirectShow 레퍼런스 인터페이스 IEncoderAPI GetParameterRange   [목차열람] [주소복사] [슬롯비우기]
IEncoderAPI::GetParameterRange
 
Microsoft DirectX 9.0

IEncoderAPI::GetParameterRange

주 : IEncoderAPI 인터페이스의 사용은 피하는 것. 대신에ICodecAPI 를 사용한다.

GetParameterRange 메서드는, 인수가 특정의 값의 리스트는 아니고, 스텝 되는 범위를 지원 하는 것 같은 경우에, 인수가 지원 하는 유효한 값의 범위를 얻어온다.

구문

HRESULT GetParameterRange(
  const GUID*  Api,
  VARIANT*  ValueMin,
  VARIANT*  ValueMax,
  VARIANT*  SteppingDelta
);

파라미터

Api

[in]  파라미터를 지정하는 GUID 의 포인터.

ValueMin

[out]  파라미터의 최소 값을 받는 VARIANT 형의 포인터.

ValueMax

[out]  파라미터의 최대치를 받는 VARIANT 형의 포인터.

SteppingDelta

[out]  ValueMin 로부터 ValueMax 에의 유효한 증분을 정의하는 스텝 델타를 받는 VARIANT 형의 포인터.

반환값

메서드가 성공하면 S_OK 를 돌려준다. 실패 하면 HRESULT 에러 코드를 돌려준다.

주의

Api 가 ENCAPIPARAM_BITRATE_MODE 와 동일한 경우, bit rate 모드 정수는 특정의 값의 리스트이므로, 이 메서드는 E_NOTIMPL 를 돌려준다.

이 파라미터의 유효한 범위는 [ValueMin ... ValueMax] 로, 증분은 SteppingDelta 이다. 파라미터가, 값의 스텝 범위를 지원 하고 있는 경우, 다음에 나타내는 변형형의 어느쪽이든을 사용해야 한다.

정의상, 이 파라미터는 특정의 형태를 돌려준다.

어느 스텝값도 유효하다. 범위가 스텝 델타를 가지고 있지 않은 경우 (즉, 임의의 값만 인크리먼트(increment) 할 수 있는 경우), 엔코더는 SteppingDelta 에 대해하늘의 값 (VT_EMPTY)을 돌려준다.

참조

↑TOP