Funzione di callback PCONVERTTREETOSTREAM (bthsdpddi.h)

La funzione Bluetooth SdpConvertTreeToStream viene usata per produrre una rappresentazione bytestream non elaborata di un record SDP da una rappresentazione ad albero. La versione di bytestream non elaborata è adatta per la pubblicazione in un server SDP locale.

Sintassi

PCONVERTTREETOSTREAM Pconverttreetostream;

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

Parametri

Root

Nodo radice della rappresentazione basata sull'albero del record SDP da convertire in una rappresentazione basata su flusso.

Stream

Puntatore al buffer che riceve il flusso SDP convertito.

Size

Indirizzo di un intero lungo senza segno per ricevere la lunghezza del flusso SDP convertito.

tag

Specifica un tag di pool a 4 byte che identifica in modo univoco il driver che esegue l'allocazione della memoria. Per altre informazioni sui tag del pool, vedere ExAllocatePoolWithTag.

Valore restituito

I valori restituiti possibili includono:

STATUS_SUCCESS

STATUS_INSUFFICIENT_RESOURCES

STATUS_INVALID_PARAMETER

Commenti

La funzione SdpConvertTreeToStream esegue l'operazione opposta come funzione SdpConvertStreamToTree . Genera un record SDP nativo completo da una struttura ad albero specifica di Microsoft. Gli sviluppatori di driver potrebbero trovare più comodo creare un record SDP come albero e quindi convertirlo in un flusso prima della pubblicazione.

SdpConvertTreeToStream alloca la memoria necessaria per archiviare la versione del flusso del record SDP. Quando la memoria non è più necessaria, il chiamante è responsabile della liberazione della memoria usando la routine di supporto del driver ExFreePool .

I driver del profilo Bluetooth possono ottenere un puntatore a questa funzione tramite la BTHDDI_SDP_PARSE_INTERFACE.

Requisiti

Requisito	Valore
Client minimo supportato	Versioni:_Supported in Windows Vista e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	bthsdpddi.h (includere BthSdpddi.h)
IRQL	<= PASSIVE_LEVEL

Vedi anche

BTHDDI_SDP_PARSE_INTERFACE

ExFreePool

SdpConvertStreamToTree