DirectShow DirectShow 레퍼런스 인터페이스 IFilterGraph2 AddSourceFilterForMoniker [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
AddSourceFilterForMoniker 메서드는, 모니카에 근거한 소스 필터를 추가한다. 예를 들어, 비디오 캡춰 장치등의 시스템 장치용의 모니카를 취득해, 그 장치용의 비디오 캡춰 필터를 추가할 수 있다 (시스템디바이스 모니커의 더 자세한 정보는, 「ICreateDevEnum 인터페이스」를 참조할것).
구문
HRESULT AddSourceFilterForMoniker(
IMoniker *pMoniker,
IBindCtx *pCtx,
LPCWSTR lpcwstrFilterName,
IBaseFilter **ppFilter
);
파라미터
pMoniker
[in] IMoniker 인터페이스의 포인터.
pCtx
[in] IBindCtx 바인드 콘텍스트 인터페이스의 포인터.
lpcwstrFilterName
[in] 필터명의 포인터.
ppFilter
[out] IBaseFilter 인터페이스 포인터를 받는 변수의 주소.
반환값
HRESULT 값을 돌려준다. 가능한 값은 다음과 같다.
값 | 설명 |
S_OK | 성공. |
VFW_S_DUPLICATE_NAME | 성공이지만, 지정된 이름이 중복 하고 있었으므로, 필터 그래프 매니저가 이름을 변경했다. |
E_FAIL | 실패. |
E_OUTOFMEMORY | 메모리 부족. |
VFW_E_DUPLICATE_NAME | 이름이 중복 한 필터의 추가에 실패했다. |
VFW_E_CANNOT_LOAD_SOURCE_FILTER | 소스 필터를 로드할 수 없다. |
VFW_E_UNKNOWN_FILE_TYPE | 이 파일의 미디어 타입이 인식되지 않는다. |
주의
지정된 모니카를 위한 소스 필터를 그래프에 추가 할 때IMoniker::BindToStorage COM 멤버 함수는 IStream 인터페이스를 문의한다. 이것에 실패 하면,IMoniker::BindToObject 가 IBaseFilter 인터페이스를 취득하려고 한다.
참조