Função de retorno de chamada PCONVERTTREETOSTREAM (bthsdpddi.h)

A função Bluetooth SdpConvertTreeToStream é usada para produzir uma representação de bytestream bruta de um registro SDP de uma representação de árvore. A versão bruta do bytestream é adequada para publicação em um servidor SDP local.

Sintaxe

PCONVERTTREETOSTREAM Pconverttreetostream;

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

Parâmetros

Root

O nó raiz da representação baseada em árvore do registro SDP a ser convertido em uma representação baseada em fluxo.

Stream

Um ponteiro para o buffer que recebe o fluxo SDP convertido.

Size

O endereço de um inteiro longo sem sinal para receber o comprimento do fluxo SDP convertido.

tag

Especifica uma marca de pool de 4 bytes que identifica exclusivamente o driver que faz a alocação de memória. Para obter mais informações sobre marcas de pool, consulte ExAllocatePoolWithTag.

Retornar valor

Os possíveis valores retornados incluem:

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Comentários

A função SdpConvertTreeToStream executa a operação oposta como a função SdpConvertStreamToTree . Ele gera um registro SDP nativo completo de uma estrutura de árvore específica da Microsoft. Os desenvolvedores de driver podem achar mais conveniente criar um registro SDP como uma árvore e convertê-lo em um fluxo antes da publicação.

SdpConvertTreeToStream aloca a memória necessária para armazenar a versão de fluxo do registro SDP. Quando a memória não é mais necessária, o chamador é responsável por liberar a memória usando a rotina de suporte do driver ExFreePool .

Os drivers de perfil Bluetooth podem obter um ponteiro para essa função por meio do BTHDDI_SDP_PARSE_INTERFACE.

Requisitos

Confira também

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree