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