INDICATION_PARAMETERS_ENHANCED 구조체(bthddi.h)

아티클
02/06/2025

INDICATION_PARAMETERS_ENHANCED 구조체는 프로필 드라이버의 향상된 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

IndicationRemoteConnect INDICATION_CODE 값이 향상된 콜백 함수의 표시 매개 변수에 지정될 때 호출 함수에 전달되는 PSM(Protocol/Service Multiplexer)입니다.

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)

통사론

회원

요구 사항

피드백

추가 리소스