IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

Driver audio mengeluarkan kode kontrol IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR untuk mendapatkan informasi tentang antarmuka perangkat GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS yang diaktifkan.

Catatan IOCTL ini menggantikan IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES dan IOCTL_BTHHFP_DEVICE_GET_CONTAINERID yang sekarang telah tidak digunakan lagi.

 

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak ada.

Panjang buffer input

Tidak ada.

Buffer output

Buffer yang berisi struktur BTHHFP_DESCRIPTOR diikuti oleh data lain yang direferensikan oleh struktur. Ini benar, jika ukuran buffer output cukup dan permintaan berhasil. Secara khusus, buffer menyertakan penyimpanan untuk string yang dirujuk oleh bidang FriendlyName dari struktur BTHHFP_DESCRIPTOR .

Panjang buffer output

Ukuran struktur BTHHFP_DESCRIPTOR dan data yang dirujuk.

Blok status

Jika rutinitas berhasil, maka Status diatur ke STATUS_SUCCESS dan anggota Informasi adalah jumlah byte yang ditulis rutin ke buffer output.

Catatan Ini bisa lebih besar dari ukuran struktur BTHHFP_DESCRIPTOR , karena buffer output mungkin berisi data lain yang dirujuk oleh struktur

 

Jika Status diatur ke STATUS_BUFFER_TOO_SMALL, maka driver audio harus membaca anggota Informasi untuk mendapatkan ukuran buffer yang harus dialokasikan pemanggil untuk permintaan ini.

Keterangan

Driver audio mengirimkan permintaan ini untuk mendapatkan informasi tentang antarmuka perangkat GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS yang diaktifkan. Informasi tidak berubah saat antarmuka diaktifkan, tetapi dapat berubah saat antarmuka dinonaktifkan. Oleh karena itu driver audio mengirimkan permintaan ini tak lama setelah menemukan antarmuka perangkat yang diaktifkan dan menggunakan informasi untuk membangun struktur KSFILTER_DESCRIPTOR yang sesuai.

Driver audio mengirimkan permintaan ini sekali dengan ukuran buffer output nol (0) untuk menentukan ukuran buffer output yang diperlukan. Dalam hal ini, permintaan akan selesai dengan Status STATUS_BUFFER_TOO_SMALL dan mengatur anggota Informasi ke ukuran buffer yang diperlukan. Driver audio kemudian mengalokasikan ruang penyimpanan yang diperlukan dan mengirim permintaan lagi. Biasanya driver audio akan menyimpan pointer ke lokasi penyimpanan ini dalam konteks perangkatnya untuk referensi selama aktivitas nanti.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Header	bthhfpddi.h

Lihat juga

Bluetooth HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES