структура 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, которая в файле заголовка Ntdef.h определяется как 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 , см. в разделе How to Get the Connection Settings for a Device.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 8.
Верхняя часть reshub.h

См. также раздел

SPB_CONNECTION_PARAMETERS

SpbTargetGetConnectionParameters

PNP_SERIAL_BUS_DESCRIPTOR