_BRB_L2CA_REGISTER_SERVER 구조체(bthddi.h)

아티클
02/22/2024

프로필 드라이버는 _BRB_L2CA_REGISTER_SERVER 구조를 사용하여 원격 Bluetooth 디바이스에서 L2CAP 연결을 수신할 수 있는 서버로 등록합니다.

구문

struct _BRB_L2CA_REGISTER_SERVER {
  BRB_HEADER                     Hdr;
  BTH_ADDR                       BtAddress;
  USHORT                         PSM;
  ULONG                          IndicationFlags;
  PFNBTHPORT_INDICATION_CALLBACK IndicationCallback;
  PVOID                          IndicationCallbackContext;
  PVOID                          ReferenceObject;
  OUT L2CAP_SERVER_HANDLE        ServerHandle;
};

멤버

Hdr

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

BtAddress

알림을 받을 원격 Bluetooth 디바이스의 주소입니다. 들어오는 연결에 대한 알림을 받을 BTH_ADDR_NULL 지정합니다.

PSM

연결 요청을 수락하는 프로토콜/서비스 멀티플렉서(PSM)입니다.

IndicationFlags

프로필 드라이버가 연결 알림 외에도 페어링 알림을 허용할지 여부를 나타내는 선택적 플래그 또는 플래그 조합입니다. 다음 표에서는 가능한 플래그 설정을 나열합니다.

플래그	설명
INDICATION_PAIR_DEVICE	프로필 드라이버는 디바이스가 페어링될 때 알림을 수락합니다.
INDICATION_UNPAIR_DEVICE	프로필 드라이버는 디바이스가 페어링되지 않은 경우 알림을 수락합니다.
INDICATION_UNPERSONALIZE_DEVICE	프로필 드라이버는 디바이스가 개인화되지 않은 경우 알림을 수락합니다.

IndicationCallback

프로필 드라이버에서 구현한 L2CAP 콜백 함수는 Bluetooth 드라이버 스택이 를 호출하여 들어오는 L2CAP 연결에 대해 프로필 드라이버에 알려야 합니다.

IndicationCallbackContext

IndicationCallback 멤버에 지정된 콜백 함수에 전달할 컨텍스트입니다.

ReferenceObject

참조 횟수를 유지하기 위해 ObReferenceObject 및 ObDereferenceObject 함수에 전달할 개체에 대한 포인터입니다. 프로필 드라이버는 드라이버 스택이 IndicationCallback 멤버에 지정된 콜백 함수를 호출할 수 있는 한 Bluetooth 드라이버 스택이 개체 수를 늘릴 수 있는 방식으로 이 개체를 제공해야 합니다. Bluetooth 드라이버 스택은 프로필 드라이버가 를 빌드하고 보낼 때 개체의 참조 수를 줄입니다. BRB_L2CA_UNREGISTER_SERVER 요청.

ServerHandle

성공적으로 반환된 경우 L2CAP 서버에 대한 핸들입니다. 프로필 드라이버가 더 이상 원격 연결 표시를 받지 않아야 하는 경우 이 핸들을 에 전달해야 합니다. BRB_L2CA_UNREGISTER_SERVER.

설명

자신을 L2CAP 서버로 등록하려면 프로필 드라이버가 를 빌드하고 보내야 합니다. BRB_L2CA_REGISTER_SERVER 요청.

프로필 드라이버가 자체 등록되면 Bluetooth 드라이버 스택이 PSM에서 연결을 수락할 수 있도록 BRB_REGISTER_PSM 요청을 빌드하고 보내야 합니다.

성공하면 원격 디바이스가 특정 PSM의 프로필 드라이버에 대한 L2CAP 연결을 만들려고 할 때 Bluetooth 드라이버 스택이 프로필 드라이버에 알릴 수 있습니다.

프로필 드라이버는 _BRB_L2CA_REGISTER_SERVER 구조체의 Psm 멤버를 0으로 지정할 수 있습니다. 즉, PSM이 지정되지 않음을 의미하며, 프로필 드라이버는 이후에 BRB_REGISTER_PSM BRB를 실행하여 연결 알림을 등록할 동적 PSM을 가져옵니다. PSM에 대한 자세한 내용은 _BRB_PSM 참조하세요.

프로필 드라이버가 자체 등록되면 프로필 드라이버가 구현하고 IndicationCallback 멤버에 지정하는 L2CAP 콜백 함수를 호출하여 원격 디바이스가 연결을 시도할 때 Bluetooth 드라이버 스택이 이를 알릴 수 있습니다.

L2CAP 서버 및 PSM에 대한 자세한 내용은 Bluetooth 프로필 드라이버에서 L2CAP Connections 수락을 참조하세요.

프로필 드라이버가 연결 시도 알림을 받으면 를 빌드하고 보내야 합니다. BRB_L2CA_OPEN_CHANNEL_RESPONSE BRB는 연결 시도를 수락하거나 거부합니다. L2CAP 연결 시도를 수락하거나 거부하는 방법에 대한 자세한 내용은 _BRB_L2CA_OPEN_CHANNEL 구조를 참조하세요.

연결이 설정되면 프로필 드라이버는 다른 BRB를 실행하여 원격 디바이스와 통신할 수 있습니다.

원격 연결 알림 수신을 중지하려면 프로필 드라이버가 를 빌드하고 보내야 합니다. BRB_L2CA_UNREGISTER_SERVER 요청.

이 절차를 통해 프로필 드라이버는 들어오는 연결 요청을 수락할 수 있지만 SDP를 사용하여 서비스를 자동으로 보급하지는 않습니다. SDP를 사용하여 서비스를 보급하려면 프로필 드라이버가 SDP API를 사용하여 SDP 레코드를 제출해야 합니다. SDP를 사용하는 광고 서비스에 대한 자세한 내용은 SDP 서버와 통신을 참조하세요.