IKsPin::KsGetCurrentCommunication 메서드(ksproxy.h)

  • 아티클

KsGetCurrentCommunication 메서드는 핀의 현재 통신 방향, 인터페이스 및 매체를 검색합니다.

구문

HRESULT KsGetCurrentCommunication(
  [out, optional] KSPIN_COMMUNICATION *Communication,
  [out, optional] KSPIN_INTERFACE     *Interface,
  [out, optional] KSPIN_MEDIUM        *Medium
);

매개 변수

[out, optional] Communication

핀의 현재 통신 방향을 설명하는 KSPIN_COMMUNICATION 열거형 형식에서 다음 값 중 하나를 수신하는 변수에 대한 포인터입니다.

값 Description
KSPIN_COMMUNICATION_NONE 핀 팩터리는 핀 인스턴스를 만들지 않습니다.
KSPIN_COMMUNICATION_SINK 핀 팩터리는 IRP 싱크 핀의 인스턴스를 만듭니다. 이러한 핀은 IRP 원본 핀에만 연결할 수 있습니다.
KSPIN_COMMUNICATION_SOURCE 핀 팩터리는 IRP 원본 핀의 인스턴스를 만듭니다. 이러한 핀은 IRP 싱크 핀에만 연결할 수 있습니다.
KSPIN_COMMUNICATION_BOTH 핀 팩터리는 IRP 싱크 및 IRP 원본인 핀 인스턴스를 만듭니다.
KSPIN_COMMUNICATION_BRIDGE 핀은 다른 핀에 연결할 수 없지만 KS I/O가 아닌 요청을 수신하기 위해 핀에 인스턴스를 만들 수 있습니다.

[out, optional] Interface

핀의 현재 인터페이스를 설명하는 KSPIN_INTERFACE 구조를 수신하는 변수에 대한 포인터입니다.

[out, optional] Medium

핀의 현재 매체를 설명하는 KSPIN_MEDIUM 구조를 수신하는 변수에 대한 포인터입니다.

반환 값

성공하면 NOERROR를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

원본 핀은 싱크 핀에 IRP를 보냅니다. 통신 방향을 데이터 흐름 방향과 혼동하지 마세요. ( KSPROPERTY_PIN_DATAFLOW 참조하세요.) 원본 핀은 데이터를 읽거나 쓸 수 있으며 싱크 핀에는 데이터를 읽거나 쓸 수 있습니다.

핀의 현재 통신 방향, 인터페이스 및 중간은 핀에서 사용할 수 있는 하위 집합이며 핀 핸들을 만들 때 선택됩니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 ksproxy.h(Ksproxy.h 포함)

추가 정보

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW