PCONVERTSTREAMTOTREE コールバック関数 (bthsdpddi.h)

[アーティクル]
04/18/2024

Bluetooth SdpConvertStreamToTree 関数は、元のストリームベースの表現を変更せずに、Microsoft 独自のツリーベースの SDP レコード表現を作成するために使用されます。

構文

PCONVERTSTREAMTOTREE Pconvertstreamtotree;

NTSTATUS Pconvertstreamtotree(
  PUCHAR Stream,
  ULONG Size,
  PSDP_TREE_ROOT_NODE *Node,
  ULONG tag
)
{...}

パラメーター

Stream

ツリーベースの表現に変換する SDP レコードストリーム。

Size

ソース SDP レコードストリームのサイズ。

Node

SDP ツリーベースの SDP レコード表現のルートとして機能するSDP_TREE_ROOT_NODE構造体へのポインター。

tag

メモリ割り当てを行うドライバーを一意に識別する 4 バイトプールタグを指定します。プールタグの詳細については、「 ExAllocatePoolWithTag」を参照してください。

戻り値

可能な戻り値は次のとおりです。

STATUS_SUCCESS
STATUS_INSUFFICIENT_RESOURCES
STATUS_INVALID_PARAMETER

注釈

ツリーはポインターを評価することで走査できるため、 SdpConvertStreamToTree 関数を使用すると、プロファイルドライバーが SDP レコードから情報を簡単に抽出できます。

SdpConvertStreamToTree 関数の呼び出しによって生じる SDP レコードのツリー表現は、相互接続された一連のSDP_NODE構造体で構成されます。ルートノードには、1 つのSDP_TREE_ROOT_NODE構造が含まれています。

各SDP_NODE構造体には、 SDP_NODE_HEADER 構造体と SDP_NODE_DATA 共用体が含まれています。ヘッダーはデータの種類を指定し、Bluetooth プロファイルドライバーは、LIST_ENTRYシステム構造を介してピア SDP_NODE構造体へのリンクにアクセスできます。この構造体と Node.hdr.Link.FlinkNode.hdr.Link.Blinkを評価することで、ドライバーはツリー内のピアノードのアドレスを取得できます。 LIST_ENTRY構造体内のポインターは、他のLIST_ENTRY構造体へのアドレスを保持し、Bluetooth ドライバーは 、CONTAINING_RECORD メモリマネージャーマクロを使用して、格納されているノードレコードのアドレスを抽出する必要があることに注意してください。

SDP_NODE_DATA共用体のシーケンスと代替メンバーを使用すると、プロファイルドライバーはツリーのサブ要素にアクセスできます。ノードのデータ型が SDP_TYPE_SEQUENCE場合、ノードは SDP シーケンスです。ノードのデータ型が SDP_TYPE_ALTERNATIVE場合、ノードは SDP 代替シーケンスです。最初のケースでは、シーケンスメンバーは有効であり、シーケンスに対応するツリーの部分にアクセスするために必要な情報が含まれています。 2 番目のケースでは、代替メンバーは有効であり、代替に対応するツリーの部分にアクセスするために必要な情報が含まれています。 シーケンスまたは代替メンバーを使用すると、シーケンスまたは代替のノードにアクセスするために使用される追加のSDP_NODE_HEADER構造が含まれます。たとえば、 node->u.sequence.Flinkノードによって表されるシーケンスの最初のメンバーのLIST_ENTRY構造体を指します。

データ共用体の残りのメンバーには、SDP ストリームから抽出された実際のデータが含まれています。ほとんどの型では、データは構造体に直接存在します。ただし、文字列と URL の場合、実際のデータへのポインターが提供されます。文字列のメモリは SdpConvertStreamToTree 関数呼び出しによって割り当てられ、ツリーの SdpFreeTree 関数を呼び出して解放する必要があります。

Bluetooth プロファイルドライバーは、 BTHDDI_SDP_PARSE_INTERFACEを介してこの関数へのポインターを取得できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョン:_Supported。
対象プラットフォーム	デスクトップ
Header	bthsdpddi.h (BthSdpddi.h を含む)
IRQL	<= PASSIVE_LEVEL