PRETRIEVEUINT64 Rückruffunktion (bthsdpddi.h)

Die Bluetooth SdpRetrieveUint64-Funktion wird verwendet, um eine nicht ausgerichtete 64-Bit-Ganzzahl aus einem SDP-Stream zu kopieren.

Syntax

PRETRIEVEUINT64 Pretrieveuint64;

void Pretrieveuint64(
  PUCHAR Stream,
  PULONGLONG pUint16
)
{...}

Parameter

Stream

Zeiger auf die Quelladresse für die nicht ausgerichtete ganze 64-Bit-Zahl.

pUint16

Zeiger auf die Adresse einer ausgerichteten Variablen, um die ganze 64-Bit-Zahl zu empfangen.

Rückgabewert

Keine

Bemerkungen

Die SdpRetrieveUint64-Funktion sucht nicht nach der nicht ausgerichteten ganzen Zahl, die kopiert werden soll. Der parameter Stream muss die genaue Adresse der ganzen Zahl ohne Vorzeichen angeben, die extrahiert werden soll.

Einige Prozessorarchitekturen erfordern, dass Werte im Arbeitsspeicher ausgerichtet werden und einen Fehler generieren, wenn versucht wird, auf einen falsch ausgerichteten Wert zuzugreifen. SDP-Datensätze werden ohne Berücksichtigung von Prozessorausrichtungsregeln erstellt. Wenn SDP-Datensätze im Arbeitsspeicher gespeichert werden, können sie Elemente enthalten, die gemäß den Ausrichtungsregeln des lokalen Prozessors falsch ausgerichtet sind.

Die SdpRetrieveUint64-Funktion kopiert unausgerichtete ganze Zahlen sicher auf Computern, die Ausrichtungsanforderungen haben, und kopiert effizient nicht ausgerichtete ganze Zahlen auf Computern, die keine Anforderungen haben. Darüber hinaus funktioniert diese Funktion für ganze Zahlen, die ordnungsgemäß ausgerichtet sind.

Diese Funktion hat keine Auswirkungen auf die Bytereihenfolge.

Bluetooth-Profiltreiber können einen Zeiger auf diese Funktion über die BTHDDI_SDP_PARSE_INTERFACE Struktur.

Anforderungen

Weitere Informationen

BTHDDI_SDP_PARSE_INTERFACE