Função de retorno de chamada PCONVERTTREETOSTREAM (bthsdpddi.h)
A função SdpConvertTreeToStream Bluetooth é usada para produzir uma representação de bytestream bruto de um registro SDP de uma representação de árvore. A versão de bytestream bruto é 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 de SDP convertido.
Size
O endereço de um inteiro longo sem sinal para receber o comprimento do fluxo de SDP convertido.
tag
Especifica uma marca de pool de 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.
Valor de retorno
Os valores de retorno possíveis incluem:
- STATUS_SUCCESS
- STATUS_INSUFFICIENT_RESOURCES
- STATUS_INVALID_PARAMETER
Observações
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
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Versões:_Supported no Windows Vista e posterior. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | bthsdpddi.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |