Funzione di callback PGETNEXTELEMENT (bthsdpddi.h)
La funzione Bluetooth SdpGetNextElement viene usata per scorrere le voci trovate in un flusso di record SDP.
Sintassi
PGETNEXTELEMENT Pgetnextelement;
void Pgetnextelement(
PUCHAR Stream,
ULONG StreamSize,
PUCHAR CurrentElement,
PUCHAR *NextElement,
PULONG NextElementSize
)
{...}
Parametri
Stream
Puntatore al flusso di record SDP per scorrere.
StreamSize
Intero long senza segno che indica le dimensioni del flusso SDP.
CurrentElement
Puntatore alla voce attualmente selezionata nel flusso SDP. Questo parametro può accettare un valore NULL.
NextElement
Puntatore a una variabile di caratteri senza segno che riceve l'indirizzo della voce successiva nel flusso del contenitore SDP.
NextElementSize
Puntatore a una variabile long integer senza segno che riceve le dimensioni della voce successiva nel flusso del contenitore SDP.
Valore restituito
Nessuno
Osservazioni
La funzione SdpGetNextElement opera direttamente su flussi non verificati e non richiede al chiamante di eseguire la conversione da una rappresentazione di flusso del record SDP a una rappresentazione basata su albero.
La funzione SdpGetNextElement esegue l'iterazione delle voci primarie di un flusso di contenitori, ma non esegue l'iterazione delle eventuali voci secondarie della voce specificata. Per scorrere le sotto-voci chiamare SdpGetNextElement iterativamente usando il parametro NextElement ottenuto dalla chiamata precedente.
La chiamata a questa funzione con il parametro CurrentElement impostato su NULL restituisce la prima voce nel flusso del contenitore.
I driver del profilo Bluetooth possono ottenere un puntatore a questa funzione tramite il BTHDDI_SDP_PARSE_INTERFACE struttura.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| piattaforma di destinazione | Desktop |
| intestazione | bthsdpddi.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |