KsPinGetConnectedPinInterface 함수(ks.h)

아티클
08/07/2023

KsPinGetConnectedPinInterface 함수는 PIN이 COM 스타일 인터페이스에 대해 연결된 핀을 쿼리합니다.

구문

KSDDKAPI NTSTATUS KsPinGetConnectedPinInterface(
  [in]  PKSPIN     Pin,
  [in]  const GUID *InterfaceId,
  [out] PVOID      *Interface
);

매개 변수

[in] Pin

KSPIN 구조체에 대한 포인터입니다. AVStream은 요청된 인터페이스에 대해 Pin 에 연결된 핀을 쿼리합니다.

[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은 비 AVStream 핀에 대해 IKsControl 및 IUnknown 에 대해서만 unking을 제공합니다.

unk는 Pin 이 원본 핀인 경우에만 만들어집니다. 따라서 다음 중 하나 이상이 true인 경우에만 호출이 작동합니다.

연결이 AVStream 내(핀의 연결된 핀은 AVStream 핀임)입니다.
핀 은 원본 핀입니다.

그렇지 않으면 STATUS_UNSUCCESSFUL 반환됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib
IRQL	PASSIVE_LEVEL