struktur _BRB_L2CA_REGISTER_SERVER (bthddi.h)

Artikel
03/08/2023

Driver profil menggunakan struktur _BRB_L2CA_REGISTER_SERVER untuk mendaftarkan dirinya sebagai server yang mampu menerima koneksi L2CAP dari perangkat Bluetooth jarak jauh.

Sintaks

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;
};

Anggota

Hdr

Struktur BRB_HEADER yang berisi informasi tentang BRB saat ini.

BtAddress

Alamat perangkat Bluetooth jarak jauh untuk menerima pemberitahuan. Tentukan BTH_ADDR_NULL untuk menerima pemberitahuan untuk koneksi masuk apa pun.

PSM

Protocol/Service Multiplexer (PSM) yang menerima permintaan koneksi.

IndicationFlags

Bendera opsional atau kombinasi bendera yang menunjukkan apakah driver profil akan menerima pemberitahuan pemasangan selain pemberitahuan koneksi. Tabel berikut mencantumkan kemungkinan pengaturan bendera.

Bendera	Deskripsi
INDICATION_PAIR_DEVICE	Driver profil akan menerima pemberitahuan ketika perangkat dipasangkan.
INDICATION_UNPAIR_DEVICE	Driver profil akan menerima pemberitahuan ketika perangkat tidak berpasangan.
INDICATION_UNPERSONALIZE_DEVICE	Driver profil akan menerima pemberitahuan ketika perangkat tidak diopersonalisasi.

IndicationCallback

Fungsi Panggilan Balik L2CAP, yang diimplementasikan oleh driver profil, yang harus dipanggil tumpukan driver Bluetooth untuk memberi tahu driver profil tentang koneksi L2CAP masuk.

IndicationCallbackContext

Konteks yang akan diteruskan ke fungsi panggilan balik yang ditentukan dalam anggota IndicationCallback .

ReferenceObject

Penunjuk ke objek untuk diteruskan ke fungsi ObReferenceObject dan ObDereferenceObject untuk mempertahankan jumlah referensi. Driver profil harus menyediakan objek ini sedemikian sehingga tumpukan driver Bluetooth dapat meningkatkan jumlah objek selama tumpukan driver dapat memanggil fungsi panggilan balik yang ditentukan dalam anggota IndicationCallback . Tumpukan driver Bluetooth akan mengurangi jumlah referensi objek ketika driver profil membangun dan mengirim BRB_L2CA_UNREGISTER_SERVER permintaan.

ServerHandle

Tangani ke server L2CAP, jika berhasil dikembalikan. Ketika driver profil tidak boleh lagi menerima indikasi sambungan jarak jauh, driver profil harus meneruskan handel ini ke BRB_L2CA_UNREGISTER_SERVER.

Keterangan

Untuk mendaftarkan dirinya sebagai server L2CAP, driver profil harus membangun dan mengirim BRB_L2CA_REGISTER_SERVER permintaan.

Setelah driver profil mendaftarkan dirinya sendiri, kemudian harus membangun dan mengirim permintaan BRB_REGISTER_PSM sehingga tumpukan driver Bluetooth akan menerima koneksi dari PSM.

Jika berhasil, tumpukan driver Bluetooth kemudian dapat memberi tahu driver profil ketika perangkat jarak jauh mencoba membuat koneksi L2CAP ke driver profil pada PSM tertentu.

Driver profil dapat menentukan nol anggota Psm dari struktur _BRB_L2CA_REGISTER_SERVER--yang berarti bahwa PSM tidak ditentukan--dan driver profil kemudian akan mengeluarkan BRB_REGISTER_PSM BRB untuk mendapatkan PSM dinamis untuk mendaftar pemberitahuan koneksi. Untuk informasi selengkapnya tentang PSM, lihat _BRB_PSM.

Setelah driver profil mendaftarkan dirinya sendiri, tumpukan driver Bluetooth dapat memberi tahunya ketika perangkat jarak jauh mencoba menyambungkannya dengan memanggil Fungsi Panggilan Balik L2CAP yang diterapkan dan ditentukan driver profil dalam anggota IndicationCallback .

Untuk informasi selengkapnya tentang server L2CAP dan PSM, lihat Menerima Connections L2CAP di Driver Profil Bluetooth.

Ketika driver profil menerima pemberitahuan tentang upaya koneksi, driver harus membangun dan mengirim BRB_L2CA_OPEN_CHANNEL_RESPONSE BRB menerima atau menolak upaya koneksi. Untuk informasi selengkapnya tentang menerima atau menolak upaya koneksi L2CAP, lihat struktur _BRB_L2CA_OPEN_CHANNEL .

Setelah koneksi dibuat, driver profil dapat mengeluarkan BRB lain untuk berkomunikasi dengan perangkat jarak jauh.

Untuk berhenti menerima pemberitahuan koneksi jarak jauh, driver profil harus membangun dan mengirim BRB_L2CA_UNREGISTER_SERVER permintaan.

Meskipun prosedur ini memungkinkan driver profil untuk menerima permintaan koneksi masuk, prosedur ini tidak secara otomatis mengiklankan layanan menggunakan SDP. Untuk mengiklankan layanan menggunakan SDP, driver profil harus mengirimkan catatan SDP menggunakan API SDP. Untuk informasi selengkapnya tentang layanan iklan dengan SDP, lihat Berkomunikasi dengan Server SDP.