IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)
音訊驅動程式會發出 IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR 控制程式代碼，以取得已啟用GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS裝置介面的相關信息。
注意此 IOCTL 會取代IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES和IOCTL_BTHHFP_DEVICE_GET_CONTAINERID已被取代。
主要程序代碼
輸入緩衝區
無。
輸入緩衝區長度
無。
輸出緩衝區
包含 BTHHFP_DESCRIPTOR 結構的緩衝區，後面接著結構所參考的任何其他數據。 如果輸出緩衝區大小足夠，且要求成功，則為 true。 特別是，緩衝區包含 BTHHFP_DESCRIPTOR 結構之FriendlyName欄位所參考之字串的記憶體。
輸出緩衝區長度
BTHHFP_DESCRIPTOR結構和參考數據的大小。
狀態區塊
如果例程成功，則 Status 會設定為 STATUS_SUCCESS，而 Information 成員是例程寫入輸出緩衝區的位元組數目。
注意 這可以大於 BTHHFP_DESCRIPTOR 結構的大小，因為輸出緩衝區可能包含結構所參考的其他數據
備註
音訊驅動程式會傳送此要求，以取得已啟用GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS裝置介面的相關信息。 啟用介面時資訊不會變更，但在停用介面時可能會變更。 因此，音訊驅動程式會在探索已啟用的裝置介面之後立即傳送此要求，並使用資訊來建置適當的KSFILTER_DESCRIPTOR結構。
音訊驅動程式會傳送此要求一次，輸出緩衝區大小為零 (0) ，以判斷所需的輸出緩衝區大小。 在此情況下，要求將會完成狀態STATUS_BUFFER_TOO_SMALL，並將 信息 成員設定為必要的緩衝區大小。 音訊驅動程序接著會配置必要的儲存空間，然後再次傳送要求。 音訊驅動程式通常會將這個儲存位置的指標儲存在其裝置內容中，以供稍後活動參考。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 標頭 | bthhfpddi.h |