IFilterMapper::RegisterFilterInstance 메서드(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
참고IFilterMapper 인터페이스는 더 이상 사용되지 않습니다. 대신 IFilterMapper2 를 사용합니다.
구문
HRESULT RegisterFilterInstance(
[in] CLSID clsid,
[in] LPCWSTR Name,
[out] CLSID *MRId
);
매개 변수
[in] clsid
필터의 GUID입니다.
[in] Name
instance 설명이 포함된 이름입니다.
[out] MRId
반환된 미디어 리소스 ID에 대한 포인터입니다. 이 매개 변수는 이 필터의 이 instance 대한 로컬 고유 식별자입니다.
반환 값
HRESULT 값을 반환합니다.
설명
이 메서드는 동일한 드라이버에 의해 구동되는 두 개의 유사한 사운드 카드를 사용할 수 있는 경우와 같은 경우를 처리하며 소리를 내보낼 카드 선택해야 합니다. 필터의 instance 하나만 있거나(예: 컴퓨터에 사운드 카드 하나만 있는 경우) 필터의 모든 인스턴스가 동일한 경우에는 필요하지 않습니다.
필터 자체가 이미 등록되어 있어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | strmif.h(Dshow.h 포함) |