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
指定針腳類型識別碼。 如果 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 釘選。中方法，以及連接結構之後指定的特定數據格式。 在這兩種情況下，如果無法接受此連線，裝置驅動程式可能會失敗此要求。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ks.h (包含 Ks.h) |