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

Bluetooth SdpConvertTreeToStream 関数は、ツリー表現から SDP レコードの生のバイトストリーム表現を生成するために使用されます。 生のバイトストリーム バージョンは、ローカル SDP サーバーでの公開に適しています。

構文

PCONVERTTREETOSTREAM Pconverttreetostream;

NTSTATUS Pconverttreetostream(
  PSDP_TREE_ROOT_NODE Root,
  PUCHAR *Stream,
  PULONG Size,
  ULONG tag
)
{...}

パラメーター

Root

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

Stream

変換された SDP ストリームを受け取るバッファーへのポインター。

Size

変換された SDP ストリームの長さを受け取る符号なし long 整数のアドレス。

tag

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

戻り値

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

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

注釈

SdpConvertTreeToStream 関数は、SdpConvertStreamToTree 関数と逆の操作を実行します。 Microsoft 固有のツリー構造から完全なネイティブ SDP レコードを生成します。 ドライバー開発者は、SDP レコードをツリーとしてビルドしてから、公開する前にストリームに変換する方が便利な場合があります。

SdpConvertTreeToStream は、SDP レコードのストリーム バージョンを格納するために必要なメモリを割り当てます。 メモリが不要になった場合、呼び出し元は ExFreePool ドライバー サポート ルーチンを使用してメモリを解放する必要があります。

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

要件

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

こちらもご覧ください

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree