Share via

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

  • Статья

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

Синтаксис

typedef struct _INDICATION_PARAMETERS_ENHANCED {
  L2CAP_CHANNEL_HANDLE ConnectionHandle;
  IN BTH_ADDR          BtAddress;
  union {
    struct {
      struct {
        OUT USHORT PSM;
      } Request;
    } Connect;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED ResponseParams;
      USHORT                             Response;
    } ConfigRequest;
    struct {
      CHANNEL_CONFIG_PARAMETERS_ENHANCED CurrentParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RequestedParams;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED RejectedParams;
      PCO_TYPE                           UnknownTypes;
      ULONG                              NumUnknownTypes;
      CHANNEL_CONFIG_PARAMETERS_ENHANCED 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;
    PVOID Reserved;
  } Parameters;
} *PINDICATION_PARAMETERS_ENHANCED, INDICATION_PARAMETERS_ENHANCED;

Члены

ConnectionHandle

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

BtAddress

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

Parameters

Parameters.Connect

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

Parameters.Connect.Request

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

Parameters.Connect.Request.PSM

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

Parameters.ConfigRequest

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

Parameters.ConfigRequest.CurrentParams

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

Parameters.ConfigRequest.RequestedParams

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

Parameters.ConfigRequest.ResponseParams

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

Parameters.ConfigRequest.Response

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

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

Parameters.ConfigResponse

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

Parameters.ConfigResponse.CurrentParams

Структура CHANNEL_CONFIG_PARAMETERS_ENHANCED , содержащая параметры для текущего канала.

Это значение допустимо только в том случае, если канал был ранее открыт и сейчас находится в процессе настройки. Этот элемент используется, когда функция обратного вызова задает значение INDICATION_CODE IndicationRemoteConfigRequest .

Parameters.ConfigResponse.RequestedParams

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

Parameters.ConfigResponse.RejectedParams

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

Parameters.ConfigResponse.UnknownTypes

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

Parameters.ConfigResponse.NumUnknownTypes

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

Parameters.ConfigResponse.NewRequestParams

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

Parameters.ConfigResponse.Response

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

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

Parameters.FreeExtraOptions

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

Parameters.FreeExtraOptions.NumExtraOptions

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

Parameters.FreeExtraOptions.ExtraOptions

Дополнительные параметры.

Parameters.Disconnect

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

Parameters.Disconnect.Reason

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

Parameters.Disconnect.CloseNow

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

Parameters.RecvPacket

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

Parameters.RecvPacket.PacketLength

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

Parameters.RecvPacket.TotalQueueLength

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

Parameters.Reserved

Зарезервированный элемент. Не используйте.

Требования

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