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 ピン インスタンス。 それ以外の場合は、KSPIN_CONNECTに接続するためのクライアントからの要求です。KSPIN_CONNECTを使用した PinId ピン。Medium メソッドと、接続構造の後に指定された特定のデータ形式。 いずれの場合も、この接続を受け入れることができない場合、デバイス ドライバーはこの要求に失敗する可能性があります。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ks.h (Ks.h を含む) |