KsPinGetConnectedFilterInterface 함수(ks.h)
KsPinGetConnectedFilterInterface 함수는 COM 인터페이스에 대한 포인터를 가져오기 위해 핀 연결된 필터를 쿼리합니다.
통사론
KSDDKAPI NTSTATUS KsPinGetConnectedFilterInterface(
[in] PKSPIN Pin,
[in] const GUID *InterfaceId,
[out] PVOID *Interface
);
매개 변수
[in] Pin
KSPIN 구조체에 대한 포인터입니다. 이 핀이 연결된 필터는 요청된 인터페이스에 대해 쿼리됩니다.
[in] InterfaceId
가져올 인터페이스의 인터페이스 ID를 나타내는 GUID에 대한 포인터입니다. 이 인터페이스에 대해 QueryInterface 호출이 자동으로 수행됩니다.
[out] Interface
PVOID에 대한 포인터입니다. COM에서와 같이 결과 인터페이스 포인터는 *Interface. 이 인터페이스에는 해당 참조 수가 있으며 com에서와 같이 호출자가 해제할 있어야 합니다.
반환 값
KsPinGetConnectedFilterInterface 연결된 필터 또는 AVStream thunk에 인터페이스가 있는 경우 STATUS_SUCCESS 반환합니다. STATUS_SUCCESS 반환되면 인터페이스 포인터가 *Interface. 그렇지 않으면 STATUS_NOINTERFACE 반환합니다. 이는 COM HRESULT E_NOINTERFACE 해당합니다.
발언
기본적으로 개체는 IUnknown 인터페이스 및 IKsControl 인터페이스를 지원합니다. 필터 및 연결된 핀이 AVStream 개체인 경우 쿼리 및 반환된 인터페이스 포인터는 다른 드라이버에 대한 직접 호출입니다. 그러나 연결된 핀 및 필터가 AVStream 드라이버에 속하지 않는 경우 필터가 포함된 드라이버에 대한 동기 호출을 통해 iKsControl 지원을 제공하는 thunk가 만들어지고 IoCallDriver사용합니다.
KsPinGetConnectedFilterInterface 가장 일반적인 사용은 핀 연결하는 필터에 대한 제어 인터페이스를 획득하는 것입니다. 그런 다음 연결된 핀에 대한 속성, 메서드 또는 이벤트 호출에 이 컨트롤 인터페이스를 사용하거나 연결된 필터에 집계된 인터페이스를 쿼리할 수 있습니다. (연결된 필터가 AVStream 필터인 경우; AVStream은 IKsControl 및 비 AVStream 필터에 대한 IUnknown )에 대해서만 unking을 제공합니다.
thunk는 핀 원본 핀인 경우에만 생성됩니다. 따라서 다음 중 하나 이상이 true인 경우에만 호출이 작동합니다.
- 연결은 AVStream(핀연결된 핀은 AVStream 핀)입니다.
- 핀 원본 핀입니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |