次の方法で共有

SPB_CONNECTION_PARAMETERS構造体 (spbcx.h)

  • [アーティクル]

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

このターゲットの接続タグへのポインター。 接続タグは、ターゲット デバイスからバスへの接続を識別する接続 ID を含む不透明な文字列です。 詳細については、「SPB-Connected 周辺機器 の接続 ID の」を参照してください。

ConnectionParameters

このターゲットの接続パラメーターへのポインター。 このメンバーは、SPB コントローラー ドライバーがターゲットと通信するために必要なターゲット固有のパラメーターを含むメモリ バッファーを指します。 詳細については、次の「解説」セクションを参照してください。

備考

この構造体には、ターゲット デバイスからバスへの接続に関する情報が含まれています。 クライアント (周辺機器ドライバー) がターゲット デバイスへの論理接続を開くと、SPB コントローラー ドライバーはデバイスの接続設定を取得し、これらの設定を格納します。 後で、クライアントからデバイスへの I/O 要求に応答して、SPB コントローラー ドライバーは接続設定を使用して、バス経由でデバイスにアクセスするようにコントローラーを構成します。

たとえば、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 呼び出します。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降でサポートされています。
ヘッダー spbcx.h

関連項目

EvtSpbTargetConnect を する

EvtSpbTargetDisconnect を する

RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER

SPB_CONNECTION_PARAMETERS_INIT

spbTargetGetConnectionParameters の