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