_BRB_SCO_OPEN_CHANNEL 구조체(bthddi.h)

아티클
08/07/2023

_BRB_SCO_OPEN_CHANNEL 구조는 원격 디바이스에 열려는 SCO 채널 또는 원격 디바이스에서 시작된 들어오는 SCO 연결 요청을 수락하거나 거부하는 프로필 드라이버의 응답을 설명합니다.

구문

struct _BRB_SCO_OPEN_CHANNEL {
  BRB_HEADER                 Hdr;
  BTH_ADDR                   BtAddress;
  ULONG                      TransmitBandwidth;
  ULONG                      ReceiveBandwidth;
  USHORT                     MaxLatency;
  USHORT                     PacketType;
  USHORT                     ContentFormat;
  USHORT                     Reserved;
  SCO_RETRANSMISSION_EFFORT  RetransmissionEffort;
  ULONG                      ChannelFlags;
  ULONG                      CallbackFlags;
  PFNSCO_INDICATION_CALLBACK Callback;
  PVOID                      CallbackContext;
  PVOID                      ReferenceObject;
  SCO_CHANNEL_HANDLE         ChannelHandle;
  UCHAR                      Response;
};

멤버

Hdr

현재 BRB에 대한 정보를 포함하는 BRB_HEADER 구조체입니다.

BtAddress

SCO 채널을 열 원격 디바이스의 Bluetooth 주소입니다.

TransmitBandwidth

SCO 채널에 할당할 전송 대역폭(초당 바이트)입니다.

ReceiveBandwidth

SCO 채널에 할당할 수신 대역폭(초당 바이트)입니다.

MaxLatency

동기 간격 합계의 상한과 (e)SCO 창의 크기를 나타내는 값(밀리초)입니다. 가능한 값은 다음 표에 나와 있습니다.

값	설명
0x0003 0x0000	다음에 사용하도록 예약됩니다.
0xFFFE 0x0004	채널에 대해 가능한 MaxLatency 값의 범위입니다.
0xFFFF	채널에 기본 설정 MaxLatency 설정이 없습니다.

PacketType

SCO 연결에서 지원하는 데이터 패킷의 형식을 나타내는 플래그 또는 플래그 조합입니다. 이러한 SCO 패킷 유형은 Bluetooth SIG에 의해 정의됩니다. 이러한 플래그에 대한 자세한 내용은 Bluetooth 사양을 참조하세요. 가능한 값은 다음과 같습니다.

SCO_HV1

SCO_HV2

SCO_HV3

SCO_EV3

SCO_EV4

SCO_EV5

ContentFormat

채널의 오디오 음성 설정입니다. 다음 정의를 사용하여 이 멤버를 인코딩합니다.

SCO_VS_AIR_CODING_DATA
SCO_VS_AIR_CODING_FORMAT_ALAW
SCO_VS_AIR_CODING_FORMAT_CVSD
SCO_VS_AIR_CODING_FORMAT_MASK
SCO_VS_AIR_CODING_FORMAT_MULAW
SCO_VS_IN_CODING_ALAW
SCO_VS_IN_CODING_LINEAR
SCO_VS_IN_CODING_MASK
SCO_VS_IN_CODING_MULAW
SCO_VS_IN_DATA_FORMAT_1C
SCO_VS_IN_DATA_FORMAT_2C
SCO_VS_IN_DATA_FORMAT_MASK
SCO_VS_IN_DATA_FORMAT_SM
SCO_VS_IN_DATA_FORMAT_US
SCO_VS_IN_SAMPLE_SIZE_8BIT
SCO_VS_IN_SAMPLE_SIZE_16BIT
SCO_VS_IN_SAMPLE_SIZE_MASK
SCO_VS_PCM_BIT_POS_MASK
SCO_VS_SETTING_DEFAULT

Reserved

다음에 사용하도록 예약됩니다. 사용하지 마십시오.

RetransmissionEffort

ASCO_RETRANSMISSION_EFFORT 채널에 대한 재전송 정책을 결정하는 열거형 값입니다.

ChannelFlags

채널 열기에 대한 요구 사항을 지정하는 플래그입니다. 유효한 플래그 값은 다음 표에 나열되어 있습니다.

플래그	설명
SCO_CF_LINK_AUTHENTICATED	링크를 인증해야 합니다.
SCO_CF_LINK_ENCRYPTED	링크를 암호화해야 합니다. 이 플래그를 설정하면 SCO_CF_LINK_AUTHENTICATED 플래그도 설정됩니다.
SCO_CF_LINK_SUPPRESS_PIN	프로필 드라이버는 사용자에게 PIN을 묻는 메시지가 표시되지 않음을 기본 설정으로 나타냅니다.

CallbackFlags

콜백 멤버에 할당된 함수를 클라이언트로 보내야 하는 시기를 지정하는 플래그입니다. 현재 유효한 플래그는 하나만 있습니다.

플래그	설명
SCO_CALLBACK_DISCONNECT	원격 디바이스의 연결이 끊어지면 프로필 드라이버에 알림을 보내야 합니다.

Callback

프로필 드라이버에서 구현하는 SCO 콜백 함수 로, Bluetooth 드라이버 스택이 를 호출하여 프로필 드라이버에 SCO 연결 변경 내용을 알려야 합니다.

CallbackContext

콜백 멤버에 지정된 콜백 함수에 전달할 컨텍스트입니다. 프로필 드라이버는 이 값을 정의합니다.

ReferenceObject

참조 수를 유지할 ObReferenceObject 및 ObDereferenceObject 에 전달할 개체에 대한 포인터입니다.

ChannelHandle

열린 채널 요청이 성공적으로 완료된 경우 SCO 채널을 식별하는 핸들입니다.

Response

로컬 서버가 들어오는 SCO 연결을 수락하거나 거부할지 여부를 나타내는 플래그입니다. 이 멤버는 BRB_SCO_OPEN_CHANNEL_RESPONSE 요청을 빌드하고 보낼 때만 사용됩니다. 유효한 플래그 값은 다음 표에 나와 있습니다.

플래그	설명
SCO_CONNECT_RSP_RESPONSE_SUCCESS	로컬 서버는 SCO 연결 요청을 수락합니다.
SCO_CONNECT_RSP_RESPONSE_NO_RESOURCES	로컬 서버는 리소스 부족으로 인해 SCO 연결 요청을 거부합니다.
SCO_CONNECT_RSP_RESPONSE_SECURITY_BLOCK	요청이 보안 요구 사항을 충족하지 않으므로 로컬 서버는 SCO 연결 요청을 거부합니다.
SCO_CONNECT_RSP_RESPONSE_BAD_BD_ADDR	로컬 서버는 지정된 Bluetooth 디바이스 주소의 연결을 허용하지 않으므로 SCO 연결 요청을 거부합니다.

설명

SCO 채널을 열려면 프로필 드라이버가 BRB_SCO_OPEN_CHANNEL 요청을 빌드하고 보내야 합니다.

요청 전에 원격 디바이스에 대한 비동기 연결 없는 링크가 없는 경우 Bluetooth 드라이버 스택은 SCO 채널을 만들기 전에 하나를 만듭니다.

원격 디바이스에서 시작한 들어오는 SCO 연결 요청을 수락하거나 거부하려면 프로필 드라이버가 를 빌드하고 보내야 합니다. BRB_SCO_OPEN_CHANNEL_RESPONSE 요청.

Bluetooth 드라이버 스택이 프로필 드라이버의 SCO 콜백 함수를 호출하고 콜백 함수의 표시 매개 변수에 ScoIndicationRemoteConnect를 전달할 때 프로필 드라이버가 BRB_SCO_OPEN_CHANNEL_RESPONSE 요청을 빌드하고 보내야 합니다.

프로필 드라이버는 이 구조체의 Response 멤버에 적절한 값을 저장하여 연결을 수락할지 여부를 지정합니다. 이 컨텍스트에서 로컬 시스템은 서버입니다.