INDICATION_PARAMETERS_ENHANCED 구조체(bthddi.h)

아티클
08/07/2023

INDICATION_PARAMETERS_ENHANCED 구조체는 프로필 드라이버의 향상된 L2CAP 콜백 함수에 Parameters 매개 변수로 전달됩니다.

구문

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

고급 콜백 함수의 Indication 매개 변수에 IndicationRemoteConnect INDICATION_CODE 값을 지정할 때 호출 함수에 전달되는 프로토콜/서비스 멀티플렉서(PSM)입니다.

Parameters.ConfigRequest

IndicationRemoteConfigRequest INDICATION_CODE 값에 대한 매개 변수를 포함하는 구조체입니다.

Parameters.ConfigRequest.CurrentParams

현재 채널에 대한 매개 변수를 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다. 이 값은 채널이 이전에 열려 있고 현재 구성 중인 경우에만 유효합니다. 이 멤버는 콜백 함수가 IndicationRemoteConfigRequest INDICATION_CODE 값을 지정할 때 사용됩니다.

Parameters.ConfigRequest.RequestedParams

구성 요청을 위해 원격 호스트에서 전달되는 매개 변수를 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다. 이 멤버는 콜백 함수가 IndicationRemoteConfigRequest INDICATION_CODE 값을 지정할 때 사용됩니다.

Parameters.ConfigRequest.ResponseParams

프로필 드라이버가 구성 요청에 응답하는 매개 변수를 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다.

Parameters.ConfigRequest.Response

구성 요청의 상태 나타내는 플래그입니다. 유효한 플래그 값은 다음 표에 나와 있습니다.

플래그	설명
CONFIG_STATUS_SUCCESS	구성 요청이 성공했습니다.
CONFIG_STATUS_DISCONNECT	향상된 L2CAP 연결이 끊어지므로 구성 요청이 실패했습니다.
CONFIG_STATUS_INVALID_PARAMETER	잘못된 매개 변수가 프로필 드라이버에 전달되었기 때문에 구성 요청이 실패했습니다.
CONFIG_STATUS_REJECT	프로필 드라이버가 구성 요청을 거부했습니다.
CONFIG_STATUS_UNKNOWN_OPTION	지정된 구성 옵션 중 하나가 프로필 드라이버에서 인식되지 않아 구성 요청이 실패했습니다.

Parameters.ConfigResponse

IndicationRemoteConfigResponse INDICATION_CODE 값에 대한 매개 변수를 포함하는 구조체입니다.

Parameters.ConfigResponse.CurrentParams

현재 채널에 대한 매개 변수를 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다.

이 값은 채널이 이전에 열려 있고 현재 구성 중인 경우에만 유효합니다. 이 멤버는 콜백 함수가 IndicationRemoteConfigRequest INDICATION_CODE 값을 지정할 때 사용됩니다.

Parameters.ConfigResponse.RequestedParams

Parameters.ConfigResponse.RejectedParams

원격 디바이스에서 거부된 구성 매개 변수 설정을 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다.

Parameters.ConfigResponse.UnknownTypes

응답 디바이스에서 인식할 수 없는 형식의 배열입니다.

Parameters.ConfigResponse.NumUnknownTypes

UnknownTypes 멤버에서 인식할 수 없는 형식 의 수입니다 .

Parameters.ConfigResponse.NewRequestParams

원격 디바이스에서 응답이 반환된 후 다시 제출할 향상된 콜백 함수에 대한 매개 변수 설정을 포함하는 CHANNEL_CONFIG_PARAMETERS_ENHANCED 구조체입니다.

Parameters.ConfigResponse.Response

구성 요청의 상태 나타내는 플래그입니다. 유효한 플래그 값은 다음 표에 나열되어 있습니다.

플래그	설명
CONFIG_STATUS_SUCCESS	구성 요청이 성공했습니다.
CONFIG_STATUS_DISCONNECT	향상된 L2CAP 연결이 끊어지므로 구성 요청이 실패했습니다.
CONFIG_STATUS_INVALID_PARAMETER	잘못된 매개 변수가 프로필 드라이버에 전달되었기 때문에 구성 요청이 실패했습니다.
CONFIG_STATUS_REJECT	프로필 드라이버가 구성 요청을 거부했습니다.
CONFIG_STATUS_UNKNOWN_OPTION	지정된 구성 옵션 중 하나가 프로필 드라이버에서 인식되지 않아 구성 요청이 실패했습니다.

Parameters.FreeExtraOptions

IndicationFreeExtraOptions INDICATION_CODE 값에 대한 매개 변수를 포함하는 구조체입니다.

Parameters.FreeExtraOptions.NumExtraOptions

ExtraOptions 멤버에 포함된 추가 옵션 수입니다.

Parameters.FreeExtraOptions.ExtraOptions

추가 옵션.

Parameters.Disconnect

IndicationRemoteDisconnect INDICATION_CODE 값에 대한 매개 변수를 포함하는 구조체입니다.

Parameters.Disconnect.Reason

원격 디바이스에 대한 L2CAP 연결이 종료된 이유를 나타내는 L2CAP_DISCONNECT_REASON 값입니다.

Parameters.Disconnect.CloseNow

프로필 드라이버가 Bluetooth 드라이버 스택에 L2CAP 연결을 닫도록 알리는 데 사용하는 부울 값입니다. 이 멤버를 TRUE 로 설정하여 Bluetooth 드라이버 스택에 연결을 닫도록 알립니다. 그렇지 않으면 연결을 열어 두려면 FALSE 로 설정합니다.

Parameters.RecvPacket

IndicationRecvPacket INDICATION_CODE 값에 대한 매개 변수를 포함하는 구조체입니다.

Parameters.RecvPacket.PacketLength

콜백 함수가 L2CAP 연결을 통해 보낸 패킷의 크기(바이트)입니다.

Parameters.RecvPacket.TotalQueueLength

L2CAP 연결을 통해 처리할 패킷 수입니다.

Parameters.Reserved

예약된 멤버입니다. 사용하지 마십시오.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	버전:Windows 8 이상 버전의 Windows에서 _Supported
머리글	bthddi.h(Bthddi.h 포함)

INDICATION_PARAMETERS_ENHANCED 구조체(bthddi.h)

구문

멤버

요구 사항

피드백

피드백

추가 리소스