IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (btlctl.h)
IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH要求會將 SDP 服務和屬性搜尋結合成單一作業。 這可讓呼叫端直接從遠端裝置取得 SDP 記錄。
主要程序代碼
輸入緩衝區
AssociatedIrp.SystemBuffer 成員包含 IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH 結構,指定要搜尋之遠端 SDP 伺服器的連線句柄、GUID 陣列,以及要搜尋的屬性值範圍。
輸入緩衝區長度
的長度 IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH 結構。
輸出緩衝區
AssociatedIrp.SystemBuffer 成員指向保存 BTH_SDP_STREAM_RESPONSE 結構的緩衝區,後面接著原始 SDP 記錄數據流。
輸出緩衝區長度
BTH_SDP_STREAM_RESPONSE 結構的長度。
狀態區塊
如果要求成功,資訊 STATUS_BLOCK 結構的成員會設定為SDP回應數據流的大小或輸出緩衝區的大小,無論大小較小。 否則,資訊 成員會設定為零。
Status 成員會設定為下表中的其中一個值。
狀態值 | 描述 |
---|---|
STATUS_SUCCESS | IOCTL 已順利完成。 |
STATUS_DEVICE_NOT_CONNECTED | SDP 服務所在的裝置未連線。 |
STATUS_INSUFFICIENT_RESOURCES | 記憶體不足,無法完成這項作業。 |
STATUS_INVALID_BUFFER_SIZE | 輸出緩衝區的大小不正確。 |
STATUS_INVALID_PARAMETER | 輸入緩衝區中的其中一個值無效。 |
STATUS_REQUEST_NOT_ACCEPTED | SDP 服務拒絕要求。 |
STATUS_TOO_MANY_GUIDS_REQUESTED | SDP 服務無法處理傳入輸入緩衝區中的 GUID 數目。 |
言論
配置文件驅動程式取得 SDP 記錄之後,就可以使用 SDP 函式來剖析它們。 這些函式的指標是由提供 BTHDDI_SDP_PARSE_INTERFACE 介面。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista 和更新版本中的版本:_Supported。 |
標頭 | btlctl.h (include Btlctl.h) |
IRQL | <= PASSIVE_LEVEL |