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

IPin::QueryId

QueryId 메서드는, 핀의 식별자를 얻어온다.

구문

HRESULT QueryId(
  LPWSTR *Id
);

파라미터

Id

[out] 핀 식별자가 들어가는 캐릭터 라인을 받는 변수의 주소.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음과 같다.

주의

이 메서드는 그래프의 영속성을 지원 한다. 이 메서드를 사용해 핀 상태를 보존해,IBaseFilter::FindPin 메서드를 사용해 그 상태를 복원하는 것. 핀의 식별자 캐릭터 라인은 필터 처리에 의해 정의된다. 식별자는 필터내에서 일의일 필요가 있다.

주 :   "핀 식별자" 는 반드시 QueryPinInfo 메서드가 돌려주는 "핀명" 과 같지 않다.

필터는 Microsoft® Win32® CoTaskMemAlloc 함수를 사용해 돌려주어진 캐릭터 라인을 할당한다. 호출원래는 CoTaskMemFree 를 사용해 그 캐릭터 라인을 반드시 릴리즈 하는 것.

참조

• 필터 그래프의 데이터 플로우
• 에러 코드와 성공 코드
• IPin 인터페이스