SdpCreateNodeTree 関数 (sdplib.h)

[アーティクル]
02/26/2024

Bluetooth SdpCreateNodeTree 関数は、空のルート SDP_TREE_ROOT_NODE 構造体を割り当てるために使用されます。

構文

PSDP_TREE_ROOT_NODE SdpCreateNodeTree(
  [in] ULONG tag
);

パラメーター

[in] tag

ノードに関連付けるプロファイルドライバー定義タグ。

戻り値

成功した場合、この関数は新しく割り当てられたSDP_TREE_ROOT_NODE構造体へのポインターを返します。成功しなかった場合、この関数は NULL を返します。

注釈

SdpCreateNodeTree 関数を呼び出すことは、SDP ツリーを構築する最初の手順です。 Bluetooth プロファイルドライバーがこの関数を使用してルートノードを割り当てた後、によって指される他の関数の呼び出しを使用してノードを設定できます。 BTHDDI_SDP_NODE_INTERFACE 構造体。

SDP ツリーが不要になった場合、Bluetooth プロファイルドライバーは SdpFreeTree 関数を呼び出して破棄する必要があります。 SdpFreeTree は、ルートノードと、それにアタッチされているすべての子ノードを解放します。ツリーやその他のリストに含まれない限り、ExFreePool ドライバーサポートルーチンを呼び出すことで、個々のSDP_NODE構造体を解放できます。

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

要件

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