RxAssociateContextWithMid-Funktion (midatlax.h)

Artikel
02/29/2024

RxAssociateContextWithMid ordnet den angegebenen undurchsichtigen Kontext einer verfügbaren Multiplex-ID (MID) aus einem MID_ATLAS zu.

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 einen 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, einschließlich, wenn die Anzahl der bereits verwendeten MIDs größer ist als die maximale Anzahl von MIDs, die beim Erstellen der MID_ATLAS-Struktur festgelegt wurde.

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. Ein MID ist eine Komponente einer MID_ATLAS Datenstruktur, die durch Aufrufen von RxCreateMidAtlas zugeordnet wird. Eine MID_MAP Datenstruktur wird zugeordnet und zum Zuordnen von MIDs zu RX_CONTEXT Datenstrukturen verwendet. RxAssociateContextWithMid weist nicht ausgelagerten Poolspeicher zu, wenn eine neue MID_MAP-Datenstruktur erstellt wird.

Der pContext-Parameter kann ein beliebiger undurchsichtiger Kontext sein, aber er ist in der Regel ein RX_CONTEXT.