Функция RxAssociateContextWithMid (midatlax.h)

  • Статья

RxAssociateContextWithMid связывает предоставленный непрозрачный контекст с доступным идентификатором мультиплекса (MID) из MID_ATLAS.

Синтаксис

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

Параметры

MidAtlas

Указатель на структуру данных MID_ATLAS.

Context

Указатель на контекст.

NewMid

Указатель на идентификатор мультиплекса, связанный с контекстом.

Возвращаемое значение

RxAssociateContextWithMid возвращает STATUS_SUCCESS при успешном выполнении или одном из следующих значений ошибки:

Код возврата Описание
STATUS_INSUFFICIENT_RESOURCES
 Эта ошибка возвращается, если не удалось выделить достаточный объем памяти для новой структуры данных MID_MAP.
STATUS_UNSUCCESSFUL
 Эта ошибка возвращается в нескольких случаях, включая случаи, когда количество уже используемых MID превышает максимальное число MID, установленное при создании структуры MID_ATLAS.

Комментарии

RDBSS определяет идентификатор мультиплекса (MID), 16-разрядное значение, которое может использоваться как сетевым клиентом (мини-перенаправителем), так и сервером для различения одновременно активных запросов при любом подключении. MID — это компонент структуры данных MID_ATLAS, выделенной путем вызова RxCreateMidAtlas. MID_MAP структура данных выделяется и используется для сопоставления MID с RX_CONTEXT структурами данных. RxAssociateContextWithMid выделяет память нестраничного пула при создании новой структуры данных MID_MAP.

Параметр pContext может быть любым непрозрачным контекстом, но обычно это RX_CONTEXT.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть midatlax.h (включая Midatlax.h)
IRQL <= APC_LEVEL

См. также раздел

RxCreateMidAtlas

RxDevicMidAtlas

RxMapAndDissociateMidFromContext

RxMapMidToContext

RxReassociateMid