共用方式為


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)

另請參閱

KSPIN_INTERFACE

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin