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