INDICATION_PARAMETERS 구조체(bthddi.h)

아티클
08/07/2023

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

구문

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

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

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

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

플래그	설명
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

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

플래그	설명
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 연결이 종료된 이유를 나타내는 L2CAP_DISCONNECT_REASON 값입니다.

Parameters.Disconnect.CloseNow

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

Parameters.RecvPacket

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

Parameters.RecvPacket.PacketLength

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

Parameters.RecvPacket.TotalQueueLength

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

설명

프로필 드라이버의 L2CAP 콜백 함수 는 Bluetooth 드라이버 스택이 콜백 함수의 표시 매개 변수에 전달하는 값에 따라 이 구조를 다르게 처리해야 합니다.

Bluetooth 드라이버 스택이 IndicationRemoteConnect를 통과하면 콜백 함수는 매개 변수 공용 구조체의 Connect 멤버를 사용해야 합니다.
Bluetooth 드라이버 스택이 IndicationRemoteDisconnect를 통과하면 콜백 함수는 Parameters 공용 구조체의 Disconnect 멤버를 사용해야 합니다.
Bluetooth 드라이버 스택이 IndicationRemoteConfigRequest를 통과하면 콜백 함수는 매개 변수 공용 구조체의 ConfigRequest 멤버를 사용해야 합니다.
Bluetooth 드라이버 스택이 IndicationRemoteConfigResponse를 통과하면 콜백 함수는 Parameters 공용 구조체의 ConfigResponse 멤버를 사용해야 합니다.
Bluetooth 드라이버 스택이 IndicationRemoteFreeExtraOptions를 통과하면 콜백 함수는 Parameters 공용 구조체의 FreeExtraOptions 멤버를 사용해야 합니다.
Bluetooth 드라이버 스택이 IndicationRemoteRecvPacket을 통과하면 콜백 함수는 Parameters 공용 구조체의 RecvPacket 멤버를 사용해야 합니다.