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