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

Статья
08/07/2023

Структура 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 используется для получения этих параметров подключения, см. в разделе How to Get the Connection Settings for a Device.

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

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