структура INDICATION_PARAMETERS (bthddi.h)

Статья
08/07/2023

Структура INDICATION_PARAMETERS передается в качестве параметра Parametersфункции обратного вызова L2CAP драйвера профиля.

Синтаксис

typedef struct _INDICATION_PARAMETERS {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS ResponseParams;
      USHORT                    Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS CurrentParams;
      CHANNEL_CONFIG_PARAMETERS RequestedParams;
      CHANNEL_CONFIG_PARAMETERS RejectedParams;
      PCO_TYPE                  UnknownTypes;
      ULONG                     NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS NewRequestParams;
      USHORT                    Response;
    } ConfigResponse;
    struct {
      ULONG                NumExtraOptions;
      PL2CAP_CONFIG_OPTION ExtraOptions;
    } FreeExtraOptions;
    struct {
      L2CAP_DISCONNECT_REASON Reason;
      BOOLEAN                 CloseNow;
    } Disconnect;
    struct {
      ULONG PacketLength;
      ULONG TotalQueueLength;
    } RecvPacket;
  } Parameters;
} *PINDICATION_PARAMETERS, INDICATION_PARAMETERS;

Члены

ConnectionHandle

Дескриптор подключения L2CAP к удаленному устройству. Этот дескриптор действителен только для уведомлений, поступающих через установленное подключение L2CAP.

BtAddress

Bluetooth-адрес удаленного устройства.

Parameters

Parameters.Connect

Структура, содержащая параметры функции обратного вызова IndicationRemoteConnect .

Parameters.Connect.Request

Структура, содержащая параметры для запроса на подключение.

Parameters.Connect.Request.PSM

Протокол-мультиплексор служб (PSM), передаваемый вызывающей функции, когда значение IndicationRemoteConnectINDICATION_CODE указано в параметре Indication функции обратного вызова.

Parameters.ConfigRequest

Структура, содержащая параметры для значения IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.CurrentParams

Структура CHANNEL_CONFIG_PARAMETERS , содержащая параметры для текущего канала. Это значение допустимо, только если канал был ранее открыт и сейчас находится в процессе настройки. Этот член используется, когда функция обратного вызова задает значение IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.RequestedParams

Структура CHANNEL_CONFIG_PARAMETERS , содержащая параметры, передаваемые с удаленного узла для запросов конфигурации. Этот член используется, когда функция обратного вызова задает значение IndicationRemoteConfigRequestINDICATION_CODE .

Parameters.ConfigRequest.ResponseParams

Структура CHANNEL_CONFIG_PARAMETERS , содержащая параметры, которые драйвер профиля отвечает на запрос конфигурации.

Parameters.ConfigRequest.Response

Флаг, указывающий состояние запроса конфигурации. Допустимые значения флагов перечислены в следующей таблице.

Flag	Описание
CONFIG_STATUS_SUCCESS	Запрос конфигурации выполнен успешно.
CONFIG_STATUS_DISCONNECT	Не удалось выполнить запрос конфигурации, так как подключение L2CAP было отключено.
CONFIG_STATUS_INVALID_PARAMETER	Сбой запроса конфигурации, так как драйверу профиля был передан недопустимый параметр.
CONFIG_STATUS_REJECT	Драйвер профиля отклонил запрос конфигурации.
CONFIG_STATUS_UNKNOWN_OPTION	Сбой запроса конфигурации, так как драйвер профиля не распознает один из указанных параметров конфигурации.

Parameters.ConfigResponse

Структура, содержащая параметры для значения IndicationRemoteConfigResponseINDICATION_CODE .

Parameters.ConfigResponse.CurrentParams

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

Структура *CHANNEL_CONFIG_PARAMETERS , содержащая параметры параметров конфигурации, отклоненные удаленным устройством.

Parameters.ConfigResponse.UnknownTypes

Массив типов, которые не были распознаны отвечающим устройством.

Parameters.ConfigResponse.NumUnknownTypes

Число нераспознанных типов в элементе UnknownTypes .

Parameters.ConfigResponse.NewRequestParams

Структура *CHANNEL_CONFIG_PARAMETERS , содержащая параметры параметров для повторной отправки функции обратного вызова после возврата ответа с удаленного устройства.

Parameters.ConfigResponse.Response

Flag	Описание
CONFIG_STATUS_SUCCESS	Запрос конфигурации выполнен успешно.
CONFIG_STATUS_DISCONNECT	Не удалось выполнить запрос конфигурации, так как подключение L2CAP было отключено.
CONFIG_STATUS_INVALID_PARAMETER	Сбой запроса конфигурации, так как драйверу профиля был передан недопустимый параметр.
CONFIG_STATUS_REJECT	Драйвер профиля отклонил запрос конфигурации.
CONFIG_STATUS_UNKNOWN_OPTION	Сбой запроса конфигурации, так как драйвер профиля не распознает один из указанных параметров конфигурации.

Parameters.FreeExtraOptions

Структура, содержащая параметры для значения IndicationFreeExtraOptionsINDICATION_CODE .

Parameters.FreeExtraOptions.NumExtraOptions

Количество дополнительных параметров, содержащихся в элементе ExtraOptions .

Parameters.FreeExtraOptions.ExtraOptions

Количество дополнительных параметров, содержащихся в элементе ExtraOptions .

Parameters.Disconnect

Структура, содержащая параметры для значения IndicationRemoteDisconnectINDICATION_CODE .

Parameters.Disconnect.Reason

Значение L2CAP_DISCONNECT_REASON , указывающее, почему подключение L2CAP к удаленному устройству было прервано.

Parameters.Disconnect.CloseNow

Логическое значение, которое драйвер профиля использует для уведомления стека драйверов Bluetooth о закрытии подключения L2CAP. Установите для этого члена значение TRUE , чтобы уведомить стек драйверов Bluetooth о закрытии подключения. В противном случае установите для него значение FALSE , чтобы не закрывать подключение.

Parameters.RecvPacket

Структура, содержащая параметры для значения IndicationRecvPacketINDICATION_CODE .

Parameters.RecvPacket.PacketLength

Размер (в байтах) пакета, отправляемого функцией обратного вызова через подключение L2CAP.

Parameters.RecvPacket.TotalQueueLength

Количество пакетов, обрабатываемых через подключение L2CAP.

Функция обратного вызова L2CAP драйвера профиля должна обрабатывать эту структуру по-разному в зависимости от значения, которое передает стек драйверов Bluetooth в параметре Индика функции обратного вызова.

Когда стек драйверов Bluetooth передает IndicationRemoteConnect, функция обратного вызова должна использовать элемент Connect объединения параметров .
Когда стек драйверов Bluetooth передает IndicationRemoteDisconnect, функция обратного вызова должна использовать элемент Disconnect объединения параметров .
Когда стек драйвера Bluetooth передает IndicationRemoteConfigRequest, функция обратного вызова должна использовать член ConfigRequest объединения Parameters .
Когда стек драйверов Bluetooth передает IndicationRemoteConfigResponse, функция обратного вызова должна использовать член ConfigResponse объединения Parameters .
Когда стек драйвера Bluetooth передает IndicationRemoteFreeExtraOptions, функция обратного вызова должна использовать член FreeExtraOptions объединения Parameters .
Когда стек драйвера Bluetooth передает IndicationRemoteRecvPacket, функция обратного вызова должна использовать член RecvPacket объединения Parameters .

Требования

Требование	Значение
Минимальная версия клиента	Versions:_Supported в Windows Vista и более поздних версий.
Верхняя часть	bthddi.h (включая Bthddi.h)

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

CHANNEL_CONFIG_PARAMETERS

INDICATION_CODE

Функция обратного вызова L2CAP

L2CAP_CONFIG_OPTION

L2CAP_DISCONNECT_REASON

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

структура INDICATION_PARAMETERS (bthddi.h)

Синтаксис

Члены

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы