IOCTL_BTH_SDP_CONNECT IOCTL (b)
IOCTL_BTH_SDP_CONNECT要求會在遠端藍牙裝置上建立 SDP 服務的連線。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員包含BTH_SDP_CONNECT結構,指定遠端 SDP 伺服器的位址、要求的逾時設定,以及連線特有的其他資訊。
輸入緩衝區長度
BTH_SDP_CONNECT 結構的長度。
輸出緩衝區
AssociatedIrp.SystemBuffer 成員包含BTH_SDP_CONNECT結構,該結構會保存遠端伺服器的 SDP 連線句柄。
輸出緩衝區長度
BTH_SDP_CONNECT 結構的長度。
狀態區塊
如果要求成功,則STATUS_BLOCK結構 的資訊成員會 設定為輸出緩衝區的大小,以位元組為單位。 否則, 信息 成員會設定為零。
Status 成員會設定為下表中的其中一個值。
狀態值 | 描述 |
---|---|
STATUS_SUCCESS | IOCTL 成功完成。 |
STATUS_DEVICE_BUSY | HCI 層目前無法接受要求。 |
STATUS_DEVICE_NOT_CONNECTED | 如果已指定快取連線,則沒有可用的快取記錄。 否則,連線在完成之前已取消。 |
STATUS_INSUFFICIENT_RESOURCES | 沒有足夠的記憶體可用來處理要求。 |
STATUS_INVALID_PARAMETER | 在輸入緩衝區中找到的結構部分不正確。 |
STATUS_PENDING | 系統目前無法回應,但很快就會嘗試。 |
備註
IOCTL_BTH_SDP_CONNECT要求可讓配置檔驅動程式取得遠端裝置的 SDP 連線句柄。 取得 SDP 連線句柄之後,配置檔驅動程式可以將它傳遞至其他 SDP IOCTL 介面,以收集遠端裝置 SDP 伺服器的相關信息。 當 SDP 查詢完成時,配置檔驅動程式必須關閉與 IOCTL_BTH_SDP_DISCONNECT 的 SDP 連線。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本中的版本:_Supported。 |
標頭 | btlctl.h (包括 Btlctl.h) |
IRQL | <= PASSIVE_LEVEL |