RxAssociateContextWithMid 函数 (midatlax.h)

项目
02/26/2024

RxAssociateContextWithMid 将提供的不透明上下文与来自MID_ATLAS的 MID) (可用多路复用 ID 相关联。

语法

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

参数

MidAtlas

指向MID_ATLAS数据结构的指针。

Context

指向上下文的指针。

NewMid

指向要与上下文关联的多路复用 ID 的指针。

返回值

RxAssociateContextWithMid 在成功时返回STATUS_SUCCESS或以下错误值之一：

返回代码	说明
STATUS_INSUFFICIENT_RESOURCES	当无法为新的MID_MAP数据结构分配足够的内存时，将返回此错误。
STATUS_UNSUCCESSFUL	对于多种情况，包括已使用的 MID 数大于创建MID_ATLAS结构时设置的最大 MID 数时，将返回此错误。

注解

RDBSS 定义了一个多路复用 ID (MID) （一个 16 位值），网络客户端 (微型重定向器) 和服务器都可以使用它来区分任何连接上的并发活动请求。 MID 是通过调用 RxCreateMidAtlas 分配的MID_ATLAS数据结构的组件。分配MID_MAP数据结构，并将其用于将 MID 映射到RX_CONTEXT数据结构。 RxAssociateContextWithMid 在创建新的MID_MAP数据结构时分配非分页池内存。

pContext 参数可以是任何不透明的上下文，但它通常是一个RX_CONTEXT。