RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 構造体 (reshub.h)
RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER構造体には、シリアル バス (I2C、SPI、または UART) に接続されているターゲット デバイスの接続プロパティが含まれています。
構文
typedef struct _RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER {
ULONG Version;
ULONG PropertiesLength;
UCHAR ConnectionProperties[ANYSIZE_ARRAY];
} RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER, *PRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER;
メンバー
Version
この構造体のバージョン番号。 このメンバーは、Reshub.h ヘッダー ファイルで定義されているRH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION定数に設定されます。
PropertiesLength
ConnectionProperties 配列の要素 0 で始まるシリアル バス接続記述子のサイズ (バイト単位)。
ConnectionProperties[ANYSIZE_ARRAY]
シリアル バス接続記述子の最初のバイト。 このバイトの直後に記述子の残りのバイトが続きます。 PropertiesLength メンバーは、記述子によって占有される合計バイト数を指定します。 ConnectionProperties メンバーの定義では、Ntdef.h ヘッダー ファイルが 1 と定義するANYSIZE_ARRAY定数を使用します。 詳細については、「解説」を参照してください。
注釈
RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER構造体の ConnectionProperties メンバーには、ターゲット デバイスのシリアル バス接続記述子の最初のバイトが含まれています。 記述子の残りのバイトは、メモリ内のこのメンバーの直後に続きます。 RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER構造体に割り当てられたバッファーは、この構造体に加えて、構造体の末尾を超えて拡張されるシリアル バス接続記述子の残りのバイトを含むのに十分な大きさです。
シリアル バス接続記述子の形式については、 ACPI 5.0 の仕様に記載されています。 便宜上、Reshub.h ヘッダー ファイルでは、ドライバーがこの記述子の値にアクセスできるように 、PNP_SERIAL_BUS_DESCRIPTOR 構造が定義されています。
SPB コントローラー ドライバーは 、SpbTargetGetConnectionParameters メソッドを呼び出して、 単純な周辺機器バス (通常は I²C または SPI) 上のターゲット デバイスの接続パラメーターを取得します。 このメソッドは、 接続 パラメーターをSPB_CONNECTION_PARAMETERS構造体に書き込みます。この構造体の ConnectionParameters メンバーは 、RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER 構造体へのポインターです。
RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER構造を使用するコード例については、「デバイスの接続設定を取得する方法」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降でサポートされています。 |
| Header | reshub.h |