Funzione RxAssociateContextWithMid (midatlax.h)

Articolo
02/29/2024

RxAssociateContextWithMid associa il contesto opaco fornito a un ID multiplex (MID) disponibile da un MID_ATLAS.

Sintassi

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

Parametri

MidAtlas

Puntatore alla struttura dei dati MID_ATLAS.

Context

Puntatore al contesto.

NewMid

Puntatore all'ID multiplex da associare al contesto.

Valore restituito

RxAssociateContextWithMid restituisce STATUS_SUCCESS in caso di esito positivo o uno dei valori di errore seguenti:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Questo errore viene restituito quando non è stato possibile allocare memoria sufficiente per la nuova struttura dei dati MID_MAP.
STATUS_UNSUCCESSFUL	Questo errore viene restituito per diversi casi, tra cui quando il numero di MID già in uso è maggiore del numero massimo di MID impostati al momento della creazione della struttura MID_ATLAS.

Commenti

RDBSS definisce un ID Multiplex (MID), un valore a 16 bit, che può essere usato sia dal client di rete (mini-redirector) che dal server per distinguere tra le richieste attive simultaneamente in qualsiasi connessione. MID è un componente di una struttura di dati MID_ATLAS allocata chiamando RxCreateMidAtlas. Una struttura dei dati MID_MAP viene allocata e usata per il mapping di MID a strutture di dati RX_CONTEXT. RxAssociateContextWithMid alloca la memoria del pool non di paging durante la creazione di una nuova struttura di dati MID_MAP.

Il parametro pContext può essere qualsiasi contesto opaco, ma è in genere un RX_CONTEXT.