Share via


IOCTL_BTH_SDP_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)

IOCTL_BTH_SDP_ATTRIBUTE_SEARCH要求は、指定された SDP レコードの属性を取得します。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

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

こちらもご覧ください

BTH_SDP_ATTRIBUTE_SEARCH_REQUEST

BTH_SDP_STREAM_RESPONSE

IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH

IOCTL_BTH_SDP_SERVICE_SEARCH