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