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 |