IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
IOCTL_BTH_SDP_ATTRIBUTE_SEARCH要求は、指定された SDP レコードの属性を取得します。
メジャー コード
[入力バッファー]
AssociatedIrp.SystemBuffer メンバーには、 BTH_SDP_ATTRIBUTE_SEARCH_REQUEST 検索する属性のリモート コンピューター範囲と他のキー メンバーを指定する構造体です。
入力バッファーの長さ
の長さ BTH_SDP_ATTRIBUTE_SEARCH_REQUEST 構造体。
出力バッファー
AssociatedIrp.SystemBuffer メンバーは、可変長の生 SDP ストリームの後に続くBTH_SDP_STREAM_RESPONSE構造体を含むバッファーを指します。
出力バッファーの長さ
BTH_SDP_STREAM_RESPONSE構造体の長さ。
ステータス ブロック
要求が成功した場合、STATUS_BLOCK構造体の Information メンバーは、 BTH_SDP_STREAM_RESPONSE のサイズ (バイト単位)、または出力バッファーのサイズのいずれか小さい方に設定されます。 それ以外の場合、 Information メンバーは 0 に設定されます。
Status メンバーは、次の表のいずれかの値に設定されます。
| ステータス値 | 説明 |
|---|---|
| STATUS_SUCCESS | IOCTL が正常に完了しました。 |
| STATUS_DEVICE_NOT_CONNECTED | SDP サービスが存在するデバイスが接続されていません。 |
| STATUS_INSUFFICIENT_RESOURCES | この操作を完了するのに十分なメモリが不足していました。 |
| STATUS_INVALID_BUFFER_SIZE | 出力バッファーのサイズが正しくありません。 |
| STATUS_INVALID_PARAMETER | 入力バッファー内の値の 1 つが無効でした。 |
| STATUS_REQUEST_NOT_ACCEPTED | SDP サービスが要求を拒否しました。 |
| STATUS_TOO_MANY_GUIDS_REQUESTED | SDP サービスは、入力バッファーに渡された GUID の数を処理できませんでした。 |
注釈
ほとんどの状況では、プロファイル ドライバーは、 を呼び出すことによって SDP サービスと属性の検索を組み合わせることができます。 IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH Ioctl。 プロファイル ドライバーが Bluetooth リンク経由で送信される SDP トラフィックの量を減らすか、少数のメッセージ転送ユニット (MTU) を使用して SDP サーバーから情報を抽出する必要がある場合、プロファイル ドライバーは を呼び出す必要があります。 IOCTL_BTH_SDP_SERVICE_SEARCH サービス検索を実行する IOCTL。 プロファイル ドライバーは、IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL を呼び出して属性検索を実行する必要があります。
出力バッファーで返されるBTH_SDP_STREAM_RESPONSE構造体には、SDP レコード全体のサイズ、BTH_SDP_STREAM_RESPONSE構造体に続く生 SDP レコード ストリームのサイズ (バイト単位)、およびそのストリームの最初のバイトに関する情報が含まれます。 可変長ストリームは、検索によって返される SDP レコード属性です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョン:_Supported。 |
| Header | bthioctl.h (Bthioctl.h を含む) |
| IRQL | <= PASSIVE_LEVEL |