PFNBTHPORT_INDICATION_CALLBACK fungsi panggilan balik (bthddi.h)

Artikel
02/26/2024

Driver profil menerapkan fungsi panggilan balik L2CAP untuk menyediakan tumpukan driver Bluetooth dengan mekanisme untuk memberi tahu driver profil tentang permintaan koneksi L2CAP masuk dari perangkat jarak jauh, dan setiap perubahan pada status koneksi L2CAP yang saat ini terbuka.

Sintaks

PFNBTHPORT_INDICATION_CALLBACK PfnbthportIndicationCallback;

void PfnbthportIndicationCallback(
  [in] PVOID Context,
  [in] INDICATION_CODE Indication,
  [in] PINDICATION_PARAMETERS Parameters
)
{...}

Parameter

[in] Context

Untuk indikasi permintaan koneksi jarak jauh yang masuk, ini adalah konteks yang ditentukan oleh driver profil di anggota IndicationCallbackContext dari _BRB_L2CA_REGISTER_SERVER struktur ketika driver profil mendaftarkan fungsi panggilan balik. Untuk perubahan pada koneksi L2CAP yang ada, ini adalah anggota CallbackContext yang ditentukan oleh driver profil saat membangun dan mengirim _BRB_L2CA_OPEN_CHANNEL BRB.

[in] Indication

Nilai INDICATION_CODE yang menunjukkan jenis peristiwa L2CAP.

[in] Parameters

Struktur INDICATION_PARAMETERS yang berisi parameter khusus peristiwa.

Menampilkan nilai

Tidak ada

Keterangan

Driver profil mendaftarkan fungsi panggilan balik L2CAP-nya dalam dua skenario berikut:

Ketika driver profil bertindak sebagai server, ia mendaftarkan fungsi panggilan balik L2CAP menggunakan anggota IndicationCallback dari _BRB_L2CA_REGISTER_SERVER struktur. Tumpukan pengandar Bluetooth kemudian dapat memberi tahu driver profil ketika perangkat jarak jauh mencoba menghubunginya.
Ketika driver profil bertindak sebagai klien dan mencoba untuk terhubung ke perangkat jarak jauh menggunakan BRB_L2CA_OPEN_CHANNEL BRB, driver profil mendaftarkan fungsi panggilan balik L2CAP-nya menggunakan anggota Callback dari struktur _BRB_L2CA_OPEN_CHANNEL yang diteruskan ketika driver profil membangun dan mengirim BRB_L2CA_OPEN_CHANNEL atau BRB_L2CA_OPEN_CHANNEL_RESPONSE permintaan.

Setelah driver profil mendaftarkan fungsi panggilan balik L2CAP-nya, fungsi panggilan balik hanya dikaitkan dengan saluran yang dibuka BRB. Tumpukan driver Bluetooth dapat memanggil fungsi panggilan balik L2CAP untuk memberi tahu driver profil tindakan yang terjadi melalui saluran terbuka ke perangkat jarak jauh. Driver profil dapat mendaftarkan fungsi panggilan balik tunggal untuk menangani pemberitahuan saluran sebagai klien dan pemberitahuan koneksi sebagai server.

Struktur INDICATION_PARAMETERS yang dipegang dalam parameter Parameter ditafsirkan sesuai dengan nilai enumerasi INDICATION_CODE yang diteruskan tumpukan driver Bluetooth ke fungsi panggilan balik L2CAP driver profil melalui parameter Indikasi . Untuk sebagian besar pemberitahuan, ada anggota serikat INDICATION_PARAMETERS yang sesuai dengan peristiwa dan berisi parameter khusus peristiwa.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Versi:_Supported di Windows Vista, dan yang lebih baru.
Target Platform	Desktop
Header	bthddi.h (termasuk Bthddi.h)
IRQL	Pengembang harus membuat kode fungsi ini untuk beroperasi di IRQL = DISPATCH_LEVEL (jika fungsi panggilan balik tidak mengakses memori halaman), atau IRQL = PASSIVE_LEVEL (jika fungsi panggilan balik harus mengakses memori halaman)

Lihat juga

INDICATION_CODE

INDICATION_PARAMETERS

_BRB_L2CA_OPEN_CHANNEL

_BRB_L2CA_REGISTER_SERVER

Share via