RxCreateMidAtlas-Funktion (midatlax.h)

Artikel
02/29/2024

RxCreateMidAtlas weist eine neue instance 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 auf zugeordnete und initialisierte MID_ATLAS Datenstruktur bei Erfolg oder einen NULL-Zeiger bei Fehler zurück.

Hinweise

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

Der MID muss in der Lage sein, die eindeutige Kennzeichnung und Identifizierung einer Anzahl von MIDs (in der Regel 50) aus einer möglichen Kombination von 65.536 Werten effizient zu verwalten. Um einen angemessenen Zeitraumkonflikt sicherzustellen, wird die Suche als dreistufige Hierarchie organisiert. Die zur Darstellung eines MID verwendeten 16 Bits werden in drei Bitfelder aufgeteilt. Die Länge des rechtssten Felds (am wenigsten signifikant) wird durch die maximale Anzahl von MIDs bestimmt, die im Atlas zulässig sein sollen. Dieser Maximalwert ist ein Parameter, der an RxCreateMidAtlas übergeben wird, wenn die MID_ATLAS Datenstruktur erstellt wird. Die verbleibende Länge wird gleichmäßig auf die nächsten beiden Felder aufgeteilt.

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

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