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 |