Bluetooth HFP DDI IOCTLs

Artikel
06/17/2023

Windows 8 memperkenalkan satu set kode kontrol I/O (IOCTL) sebagai bagian dari DDI yang memungkinkan driver audio untuk bekerja dengan driver kelas profil Hands-free (HFP), untuk mengoperasikan koneksi bypass audio Bluetooth.

Kecuali dinyatakan lain, berikut ini berlaku untuk semua IOCTL di bagian ini:

Jika permintaan berhasil, anggota Informasi dari struktur STATUS_BLOCK diatur ke ukuran, dalam byte, dari buffer output. Jika tidak, anggota Informasi diatur ke nol. Anggota Status diatur ke nilai NTSTATUS.
Semua IOCTLS memerlukan IRQL <= PASSIVE_LEVEL.
Driver audio harus menggunakan IOCTL dengan permintaan IRP_MJ_DEVICE_CONTROL.

Untuk sebagian besar kode fungsi IOCTL, driver audio harus menginisialisasi pointer FileObject di IO_STACK_LOCATION untuk driver HFP ketika driver audio menginisialisasi IRP kontrol perangkat untuk dikirim ke driver HFP. Driver audio biasanya mengambil penunjuk objek file dengan memanggil IoGetDeviceObjectPointer.

Driver audio kemungkinan akan mengirim banyak permintaan ini pada utas arbitrer (dengan kata lain, permintaan "asinkron"). Dalam kasus ini, driver audio perlu membangun IRP itu sendiri menggunakan metode IoAllocateIrp, dan mengatur bidang di IRP secara langsung daripada memanggil IoBuildDeviceIoControlRequest.

Topik berikut memberikan detail selengkapnya tentang IOCTL Windows 8 ini:

IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR

IOCTL_BTHHFP_DEVICE_GET_VOLUMEPROPERTYVALUES

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_REQUEST_CONNECT

IOCTL_BTHHFP_DEVICE_REQUEST_DISCONNECT

IOCTL_BTHHFP_DEVICE_GET_CONNECTION_STATUS_UPDATE

IOCTL_BTHHFP_SPEAKER_SET_VOLUME

IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE

IOCTL_BTHHFP_MIC_SET_VOLUME

IOCTL_BTHHFP_MIC_GET_VOLUME_STATUS_UPDATE