Share via

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