PGETNEXTELEMENT-Rückruffunktion (bthsdpddi.h)
Die Bluetooth SdpGetNextElement-Funktion wird verwendet, um die Einträge in einem SDP-Datensatzdatenstrom zu durchlaufen.
Syntax
PGETNEXTELEMENT Pgetnextelement;
void Pgetnextelement(
PUCHAR Stream,
ULONG StreamSize,
PUCHAR CurrentElement,
PUCHAR *NextElement,
PULONG NextElementSize
)
{...}
Parameter
Stream
Zeiger auf den SDP-Datensatzdatenstrom zum Durchlaufen.
StreamSize
Eine ganze Zahl ohne Vorzeichen, die die Größe des SDP-Datenstroms angibt.
CurrentElement
Ein Zeiger auf den aktuell ausgewählten Eintrag im SDP-Stream. Dieser Parameter kann einen NULL-Wert annehmen.
NextElement
Ein Zeiger auf eine Zeichenvariable ohne Vorzeichen, die die Adresse des nächsten Eintrags im SDP-Containerstream empfängt.
NextElementSize
Ein Zeiger auf eine ganzzahlige Variable ohne Vorzeichen, die die Größe des nächsten Eintrags im SDP-Containerstream empfängt.
Rückgabewert
Keine
Bemerkungen
Die SdpGetNextElement-Funktion arbeitet direkt für nicht analysierte Datenströme und erfordert nicht, dass der Aufrufer von einer Streamdarstellung des SDP-Datensatzes in eine strukturbasierte Darstellung konvertiert.
Die SdpGetNextElement-Funktion durchläuft die primären Einträge eines Containerstreams, durchläuft jedoch keine Untereinträge des angegebenen Eintrags. Um die Untereinträge zu durchlaufen, rufen Sie SdpGetNextElement iterativ mithilfe des NextElement-Parameters aus dem vorherigen Aufruf auf.
Wenn Sie diese Funktion aufrufen, wenn der CurrentElement-Parameter auf NULL festgelegt ist, wird der erste Eintrag im Containerstream zurückgegeben.
Bluetooth-Profiltreiber können einen Zeiger auf diese Funktion über die BTHDDI_SDP_PARSE_INTERFACE Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Versionen:_Supported in Windows Vista und höher. |
| Zielplattform | Desktop |
| Kopfzeile | bthsdpddi.h (include BthSdpddi.h) |
| IRQL | <= PASSIVE_LEVEL |