SPB_CONNECTION_PARAMETERS 結構 (spbcx.h)

發行項
02/29/2024

SPB_CONNECTION_PARAMETERS 結構包含簡單周邊總線上目標裝置的連接參數。

語法

typedef struct _SPB_CONNECTION_PARAMETERS {
  USHORT Size;
  PCWSTR ConnectionTag;
  PVOID  ConnectionParameters;
} SPB_CONNECTION_PARAMETERS, *PSPB_CONNECTION_PARAMETERS;

成員

Size

這個結構的大小，以位元組為單位。 SpbTargetGetConnectionParameters 方法會使用 Size 值來判斷正在使用哪一個結構版本。使用 SPB_CONNECTION_PARAMETERS_INIT 函式來初始化這個成員。如需詳細資訊，請參閱接下來的＜備註＞一節。

ConnectionTag

此目標之連接標籤的指標。連接標籤是一個不透明的字串，其中包含可識別目標裝置與總線連線的連接標識碼。如需詳細資訊，請參閱 SPB-Connected 周邊裝置的聯機標識符。

ConnectionParameters

這個目標的連接參數指標。此成員指向記憶體緩衝區，其中包含SPB控制器驅動程式與目標通訊所需的目標特定參數。如需詳細資訊，請參閱接下來的＜備註＞一節。

備註

此結構包含目標裝置與總線連線的相關信息。當用戶端 (周邊驅動程式) 開啟目標裝置的邏輯連線時，SPB 控制器驅動程式會擷取裝置的連接設定並儲存這些設定。之後，SPB 控制器驅動程式會使用連線設定來設定控制器，以透過總線存取裝置，以回應用戶端對裝置的 I/O 要求。

例如，I2C 總線上裝置的連線設定包括下列各項：

目標裝置的總線相對位址。
用來存取目標裝置的位址位數目。
用來存取目標裝置的總線時鐘頻率。

SPB_CONNECTION_PARAMETERS 結構的 ConnectionParameters 成員是緩衝區的指標，其中包含總線上目標裝置的連接設定。如需使用 ConnectionParameters 成員來取得這些連線參數的程式代碼範例，請參閱如何取得裝置的連線設定。

呼叫 SpbTargetGetConnectionParameters 方法，以取得代表目標裝置之SPBTARGET句柄的連接參數。這個方法會將連接參數寫入呼叫端提供的 SPB_CONNECTION_PARAMETERS 結構。將此結構傳遞至 SpbTargetGetConnectionParameters之前，請先呼叫 SPB_CONNECTION_PARAMETERS_INIT 函式來初始化結構。

若要代表用戶端 (周邊驅動程式) 開啟連線，SPB 架構延伸模組 (SpbCx) 呼叫 SPB 控制器驅動程式的 EvtSpbTargetConnect 回呼函式。若要關閉連線，SpbCx 會呼叫 SPB 控制器驅動程式的 EvtSpbTargetDisconnect 回呼函式。 SPB 控制器驅動程式通常會從驅動程式的 EvtSpbTargetConnect 函式呼叫 SpbTargetGetConnectionParameters。