RxCreateMidAtlas-Funktion (midatlax.h)

Artikel
02/07/2025

RxCreateMidAtlas weist eine neue Instanz MID_ATLAS Datenstruktur zu und initialisiert sie.

Syntax

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Parameter

MaximumNumberOfEntries

Die maximale Anzahl von Multiplex-IDs (MIDs), die im Atlas zulässig sind.

InitialAllocation

Die Anzahl der anfänglich zugewiesenen Multiplex-IDs.

Rückgabewert

RxCreateMidAtlas- gibt einen Zeiger zurück, um eine MID_ATLAS Datenstruktur für Erfolg oder einen NULL- Zeiger beim Fehler zuzuweisen und initialisiert zu haben.

Bemerkungen

RDBSS definiert eine Multiplex-ID (MID), einen 16-Bit-Wert, der sowohl vom Netzwerkclient (Miniumleitung) als auch vom Server verwendet werden kann, um zwischen den gleichzeitig aktiven Anforderungen für jede Verbindung zu unterscheiden.

Die TEIL muss effizient in der Lage sein, das eindeutige Tagging und die Identifizierung einer Anzahl von MIDs (in der Regel 50) aus einer möglichen Kombination von 65.536 Werten zu verwalten. Um einen ordnungsgemäßen Zeitraum-Kompromiss sicherzustellen, wird der Nachschlagevorgang als Hierarchie mit drei Ebenen organisiert. Die 16 Bit, die für die Darstellung eines TEIL verwendet werden, werden in drei Bitfelder aufgeteilt. Die Länge des am weitesten rechts gezählten Felds (am wenigsten signifikant) wird durch die maximale Anzahl von MIDs bestimmt, die im Atlas zulässig sind. Dieser Maximalwert ist ein Parameter, der an RxCreateMidAtlas übergeben wird, wenn die MID_ATLAS Datenstruktur erstellt wird. Die verbleibende Länge wird gleichmäßig zwischen den nächsten beiden Feldern aufgeteilt.

Wenn beispielsweise maximal 50 MIDs zur Erstellung zugeordnet werden sollen, beträgt die Länge des ersten Felds 6 (64 ( 2 ** 6 ) größer als 50 ). Die verbleibende Länge wird in zwei Felder mit jeweils 5 Bit aufgeteilt.

RxCreateMidAtlas weist beim Erstellen einer neuen MID_ATLAS Datenstruktur nicht ausgelagerten Poolspeicher zu.