структура SPB_CONNECTION_PARAMETERS (spbcx.h)

Статья
02/07/2025

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

Указатель на тег подключения для этого целевого объекта. Тег подключения — это непрозрачная строка, содержащая идентификатор подключения, определяющий подключение целевого устройства к шине. Дополнительные сведения см. в разделе Идентификаторы подключений для SPB-Connected периферийных устройств.

ConnectionParameters

Указатель на параметры подключения для этого целевого объекта. Этот элемент указывает на буфер памяти, содержащий целевые параметры, необходимые драйверу контроллера SPB для взаимодействия с целевым объектом. Дополнительные сведения см. в следующем разделе "Примечания".

Замечания

Эта структура содержит сведения о подключении целевого устройства к шине. Когда клиент (периферийный драйвер) открывает логическое подключение к целевому устройству, драйвер контроллера SPB извлекает параметры подключения для устройства и сохраняет эти параметры. Позже в ответ на запрос ввода-вывода от клиента к устройству драйвер контроллера SPB использует параметры подключения для настройки контроллера контроллера для доступа к устройству через шину.

Например, параметры подключения для устройства на шине I2C включают следующее:

Относительный адрес шины целевого устройства.
Количество битов адресов, используемых для доступа к целевому устройству.
Частота часов шины, используемая для доступа к целевому устройству.

Элемент ConnectionParameters структуры SPB_CONNECTION_PARAMETERS — это указатель на буфер, содержащий параметры подключения для целевого устройства на шине. Пример кода, использующий элемент ConnectionParameters для получения этих параметров подключения, см. в разделе Получение параметров подключения для устройства.

Вызовите метод SpbTargetGetConnectionParameters, чтобы получить параметры подключения для дескриптора SPBTARGET, представляющего целевое устройство. Этот метод записывает параметры подключения в структуру, предоставляемую вызывающим SPB_CONNECTION_PARAMETERS. Перед передачей этой структуры в SpbTargetGetConnectionParametersинициализировать структуру путем вызова функции SPB_CONNECTION_PARAMETERS_INIT.

Чтобы открыть подключение от имени клиента (периферийного драйвера), расширение платформы SPB (SpbCx) вызывает функции обратного вызова драйвера контроллера SPB EvtSpbTargetConnect. Чтобы закрыть подключение, SpbCx вызывает функцию обратного вызова драйвера контроллера SPB EvtSpbTargetDisconnect. Драйвер контроллера SPB обычно вызывает spbTargetGetConnectionParameters из функции драйвера EvtSpbTargetConnect.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается начиная с Windows 8.
заголовка	spbcx.h

См. также

EvtSpbTargetConnect

EvtSpbTargetDisconnect

RH_QUERY_CONNECTION_PROPERTIES_OUTPUT_BUFFER

SPB_CONNECTION_PARAMETERS_INIT

SpbTargetGetConnectionParameters

Поделиться через