Función de devolución de llamada PCONVERTTREETOSTREAM (bthsdpddi.h)
La función Bluetooth SdpConvertTreeToStream se usa para generar una representación de secuencia de bytes sin procesar de un registro SDP a partir de una representación de árbol. La versión de bytestream sin formato es adecuada para su publicación en un servidor SDP local.
Sintaxis
PCONVERTTREETOSTREAM Pconverttreetostream;
NTSTATUS Pconverttreetostream(
PSDP_TREE_ROOT_NODE Root,
PUCHAR *Stream,
PULONG Size,
ULONG tag
)
{...}
Parámetros
Root
Nodo raíz de la representación basada en árbol del registro SDP que se va a convertir en una representación basada en secuencias.
Stream
Puntero al búfer que recibe la secuencia SDP convertida.
Size
Dirección de un entero largo sin signo para recibir la longitud de la secuencia SDP convertida.
tag
Especifica una etiqueta de grupo de 4 bytes que identifica de forma única el controlador que realiza la asignación de memoria. Para obtener más información sobre las etiquetas de grupo, consulte ExAllocatePoolWithTag.
Valor devuelto
Entre los posibles valores devueltos se incluyen:
- STATUS_SUCCESS
- STATUS_INSUFFICIENT_RESOURCES
- STATUS_INVALID_PARAMETER
Comentarios
La función SdpConvertTreeToStream realiza la operación opuesta como la función SdpConvertStreamToTree . Genera un registro SDP nativo completo a partir de una estructura de árbol específica de Microsoft. Los desarrolladores de controladores pueden resultar más cómodos para crear un registro SDP como un árbol y, a continuación, convertirlo en una secuencia antes de la publicación.
SdpConvertTreeToStream asigna la memoria necesaria para almacenar la versión de secuencia del registro SDP. Cuando la memoria ya no es necesaria, el autor de la llamada es responsable de liberar la memoria mediante la rutina de compatibilidad del controlador ExFreePool .
Los controladores de perfil bluetooth pueden obtener un puntero a esta función a través del BTHDDI_SDP_PARSE_INTERFACE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Versions:_Supported en Windows Vista y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Encabezado | bthsdpddi.h (incluya BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |