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 メソッドと、接続構造の後に指定された特定のデータ形式。 どちらの場合も、この接続を受け入れられない場合、デバイス ドライバーはこの要求に失敗する可能性があります。
要件
| 要件 | 値 |
|---|---|
| Header | ks.h (Ks.h を含む) |