структура 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

Номер версии этой структуры. Этот элемент имеет значение RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_VERSION константы, которая определена в файле заголовка Reshub.h.

PropertiesLength

Размер дескриптора подключения последовательной шины в байтах, который начинается с элемента 0 массива ConnectionProperties.

ConnectionProperties[ANYSIZE_ARRAY]

Первый байт дескриптора подключения последовательной шины. За этим байтом сразу же следует оставшиеся байты дескриптора. Элемент PropertiesLength указывает общее количество байтов, занятых дескриптором. Определение элемента ConnectionProperties использует константу ANYSIZE_ARRAY, которая определяется как 1. Дополнительные сведения см. в разделе "Примечания".

Замечания

Элемент ConnectionProperties структуры RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER содержит первый байт дескриптора подключения последовательной шины для целевого устройства. Оставшиеся байты в дескрипторе немедленно следуют этому элементу в памяти. Буфер, выделенный для структуры 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.
заголовка	reshub.h

См. также

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR