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」を参照)。ソース ピンはデータの読み取りまたは書き込みを行う場合があり、シンク ピンにはデータの読み取りまたは書き込みが行われる場合があります。
ピンの現在の通信方向、インターフェイス、およびメディアは、ピンで使用可能なもののサブセットであり、ピン ハンドルの作成時に選択されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | ksproxy.h (Ksproxy.h を含む) |