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 포함) |