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,而此 IOCTL 現在已被取代。
主要程序代碼
輸入緩衝區
沒有。
輸入緩衝區長度
沒有。
輸出緩衝區
包含 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 |