RxAssociateContextWithMid-Funktion (midatlax.h)

Artikel
02/07/2025

RxAssociateContextWithMid den bereitgestellten undurchsichtigen Kontext einer verfügbaren Multiplex-ID (MID) aus einem MID_ATLAS zuordnet.

Syntax

NTSTATUS RxAssociateContextWithMid(
  PRX_MID_ATLAS MidAtlas,
  PVOID         Context,
  PUSHORT       NewMid
);

Parameter

MidAtlas

Ein Zeiger auf die MID_ATLAS Datenstruktur.

Context

Ein Zeiger auf den Kontext.

NewMid

Ein Zeiger auf die Multiplex-ID, die dem Kontext zugeordnet werden soll.

Rückgabewert

RxAssociateContextWithMid gibt STATUS_SUCCESS bei Erfolg oder einem der folgenden Fehlerwerte zurück:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Dieser Fehler wird zurückgegeben, wenn es nicht möglich war, genügend Arbeitsspeicher für die neue MID_MAP Datenstruktur zuzuweisen.
STATUS_UNSUCCESSFUL	Dieser Fehler wird für mehrere Fälle zurückgegeben, z. B. wenn die Anzahl der bereits verwendeten MIDs größer als die maximale Anzahl von MIDs ist, die beim Erstellen der MID_ATLAS-Struktur festgelegt wurden.

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. Ein TEIL ist eine Komponente einer MID_ATLAS Datenstruktur, die durch Aufrufen RxCreateMidAtlaszugeordnet wird. Eine MID_MAP Datenstruktur wird zugewiesen und zum Zuordnen von MIDs zu RX_CONTEXT Datenstrukturen verwendet. RxAssociateContextWithMid beim Erstellen einer neuen MID_MAP Datenstruktur Speicher für nicht ausgelagerten Pool zuweist.

Der pContext--Parameter kann ein undurchsichtiger Kontext sein, ist aber häufig ein RX_CONTEXT.