Share via

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

こちらもご覧ください

KSPIN_INTERFACE

KSPIN_MEDIUM

KSPROPERTY_PIN_DATAFLOW