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

IEncoderAPI::GetParameterValues

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

GetParameterValues 메서드는, 지정된 인수가 지원 하는 값의 리스트를 얻어온다.

구문

HRESULT GetParameterValues(
  const GUID*  Api,
  VARIANT**  Values
  ULONG*  ValuesCount,

);

파라미터

Api

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

Values

[out, size_is(*ValuesCount)]  값을 받는 배열의 포인터 주소.

ValuesCount

[out]  배열에 넣어지는 엔트리의 수를 나타낸다.

반환값

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

주의

이 메서드는, 인수가 지원 하는 각각의 값을 나타내는 VARIANT 형의 배열을 돌려준다.   이 배열은, 불려 간 측에야는 CoTaskMemAlloc 를 개입시켜 할당할 수 있어Values 파라미터에 넣어진다.   호출 측에 제어가 돌아오면ValuesCount 에는 그 배열내의 요소의 수가 저장 된다.   호출측은 CoTaskMemFree 를 호출해 배열을 반드시 릴리즈 하는 것.

참조

• 엔코더 API
• IEncoderAPI 인터페이스