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 を含む) |