共用方式為


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列舉型別接收下列其中一個值的變數指標:

價值 描述
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