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 eseguire l'iterazione.
StreamSize
Intero lungo 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 carattere senza segno che riceve l'indirizzo della voce successiva nel flusso del contenitore SDP.
NextElementSize
Puntatore a una variabile integer long senza segno che riceve le dimensioni della voce successiva nel flusso del contenitore SDP.
Valore restituito
nessuno
Osservazioni
La funzione SdpGetNextElement opera direttamente nei flussi non riparati e non richiede al chiamante di convertire da una rappresentazione del flusso del record SDP in una rappresentazione basata su albero.
La funzione SdpGetNextElement esegue l'iterazione delle voci primarie di un flusso di contenitori, ma non esegue l'iterazione tramite eventuali sotto-voci della voce specificata. Per eseguire l'iterazione tramite le voci secondarie chiamare SdpGetNextElement in modo iterativo usando il parametro NextElement ottenuto dalla chiamata precedente.
La chiamata a questa funzione con il parametro CurrentElement impostata su NULL restituisce la prima voce nel flusso del contenitore.
I driver del profilo Bluetooth possono ottenere un puntatore a questa funzione tramite BTHDDI_SDP_PARSE_INTERFACE struttura.
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 |