共用方式為


IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR IOCTL (bthhfpddi.h)

音訊驅動程式會發出 IOCTL_BTHHFP_DEVICE_GET_DESCRIPTOR 控制程式代碼,以取得已啟用GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS裝置介面的相關信息。

附註 此 IOCTL 取代 IOCTL_BTHHFP_DEVICE_GET_KSNODETYPESIOCTL_BTHHFP_DEVICE_GET_CONTAINERID,而此 IOCTL 現在已被取代。
 

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

沒有。

輸入緩衝區長度

沒有。

輸出緩衝區

包含 BTHHFP_DESCRIPTOR 結構的緩衝區,後面接著 結構所參考的任何其他數據。 如果輸出緩衝區大小足夠且要求成功,則這是 true。 特別是,緩衝區包含 BTHHFP_DESCRIPTOR 結構之 FriendlyName 欄位所參考字串的記憶體。

輸出緩衝區長度

BTHHFP_DESCRIPTOR 結構和參考數據的大小。

狀態區塊

如果例程成功,則 Status 會設定為 STATUS_SUCCESS,而 Information 成員是例程寫入輸出緩衝區的位元元組數目。

附註 這可能大於 BTHHFP_DESCRIPTOR 結構的大小,因為輸出緩衝區可能包含結構參考的其他數據
 
如果 Status 設定為STATUS_BUFFER_TOO_SMALL,則音訊驅動程式應該讀取 資訊 成員,以取得呼叫端應配置給此要求的緩衝區大小。

言論

音訊驅動程式會傳送此要求,以取得已啟用GUID_DEVINTERFACE_BLUETOOTH_HFP_SCO_HCIBYPASS裝置介面的相關信息。 在啟用介面時,資訊不會變更,但可以在停用介面時變更。 因此,音訊驅動程式會在探索已啟用的裝置介面后不久傳送此要求,並使用資訊來建置適當的KSFILTER_DESCRIPTOR結構。

音訊驅動程式會以零 (0) 的輸出緩衝區大小傳送此要求一次,以判斷所需的輸出緩衝區大小。 在此情況下,要求會完成狀態STATUS_BUFFER_TOO_SMALL,並將 資訊 成員設定為所需的緩衝區大小。 接著,音訊驅動程式會配置必要的儲存空間,並再次傳送要求。 音訊驅動程式通常會在其裝置內容中儲存此儲存位置的指標,以供稍後活動期間參考。

要求

要求 價值
最低支援的用戶端 Windows 8
支援的最低伺服器 Windows Server 2012
標頭 bthhfpddi.h

另請參閱

藍牙 HFP DDI IOCTLs

IOCTL_BTHHFP_DEVICE_GET_CONTAINERID

IOCTL_BTHHFP_DEVICE_GET_KSNODETYPES