KSPIN_CONNECT構造体 (ks.h)

クライアントは、KSPIN_CONNECT構造体を使用して、 KsCreatePin 呼び出しでドライバーから要求する接続を記述します。

構文

typedef struct {
  KSPIN_INTERFACE Interface;
  KSPIN_MEDIUM    Medium;
  ULONG           PinId;
  HANDLE          PinToHandle;
  KSPRIORITY      Priority;
} KSPIN_CONNECT, *PKSPIN_CONNECT;

メンバー

Interface

この接続に使用する KSPIN_INTERFACE を指定します。

Medium

この接続に使用するメディアを指定する KSPIN_MEDIUM 型の構造体。

PinId

ピンの種類 ID 番号を指定します。 PinToHandle フィールドが NULL でない場合、このフィールドには要求の送信先のソース ピンの識別子が含まれます。 それ以外の場合、このフィールドは、接続されているシンク ピンを参照します。 ピンが通信のソースとシンクの両方をサポートできる場合、これは接続での動作を伝える暗黙的な方法です。

PinToHandle

作成対象の宛先ピンの種類と、ソースの宛先の場合に接続するピンを指定します。 クライアントが自身への接続を要求すると、このメンバーは NULL になります 。 それ以外の場合は、接続要求のターゲットになります。 ソースの宛先の場合、これには接続を確立するピン インスタンスのハンドルが含まれます。 シンク変換先の場合、このフィールドには NULL が含まれており、それ以外の場合は使用されません。

Priority

接続の優先度を指定する KSPRIORITY 型の構造体 (通常はKSPRIORITY_NORMAL)。 詳細については、 KSPROPERTY_CONNECTION_PRIORITY プロパティを参照してください。

注釈

KSPIN_CONNECT場合。PinToHandle 要素は NULL ではありません。IRP_MJ_CREATEは、ソース KSPIN_CONNECTを接続するようにデバイスに指示します。PinId をKSPIN_CONNECTにピン留めします。PinToHandle pin インスタンス。 それ以外の場合は、KSPIN_CONNECTに接続するためのクライアントからの要求です。KSPIN_CONNECTを使用した PinId ピン。Medium メソッドと、接続構造の後に指定された特定のデータ形式。 どちらの場合も、この接続を受け入れられない場合、デバイス ドライバーはこの要求に失敗する可能性があります。

要件

こちらもご覧ください

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin