NdisCmRegisterSapComplete 函数 (ndis.h)

NdisCmRegisterSapComplete 返回客户端请求的最终状态,该 CM 之前NDIS_STATUS_PENDING返回,用于注册 SAP。

语法

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

参数

[in] Status

指定客户端注册 SAP 的原始请求的最终状态,NDIS_STATUS_SUCCESS或任何 CM 确定NDIS_STATUS_XXX (NDIS_STATUS_PENDING除外)。

[in] NdisSapHandle

指定注册成功时向 SAP 提供的 NDIS 句柄。 调用管理器获取此句柄作为其输入参数 ProtocolCmRegisterSap 函数。

[in] CallMgrSapContext

指定调用方提供的常驻上下文区域的句柄,如果注册成功,CM 将在此区域中维护此 SAP 的状态。 如果是这样,NDIS 会在有关此 SAP 的所有后续调用中将此句柄传递回 CM。 如果 Status 设置为除 NDIS_STATUS_SUCCESS 之外的其他值,NDIS 将忽略此参数。

返回值

备注

如果独立调用管理器使用给定 的 NdisSapHandle 调用时,其 ProtocolCmRegisterSap 函数返回NDIS_STATUS_PENDING,则必须调用 NdisCmRegisterSapComplete 。 调用 NdisCmRegisterSapComplete 会导致 NDIS 调用客户端的 ProtocolClRegisterSapComplete 函数。

如果调用管理器将 “状态” 设置为除NDIS_STATUS_SUCCESS以外的任何内容,则一旦调用 NdisCmRegisterSapComplete ,它就会认为 NdisSapHandle 无效。 在 SAP 注册失败后,CM 可以释放或重复使用在 NdisCmRegisterSapComplete 返回控制权时分配的每个 SAP 上下文区域。 如果调用管理器注册失败,NDIS 还会释放 SAP 的上下文。

只有向 NDIS 注册为协议驱动程序的独立调用管理器才能调用 NdisCmRegisterSapComplete。 提供集成呼叫管理支持的面向连接的微型端口驱动程序调用 NdisMCmRegisterSapComplete

要求

要求
最低受支持的客户端 NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisCmRegisterSapComplete (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisCmRegisterSapComplete (NDIS 5.1) ) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_CallManager_Function (ndis)

另请参阅

NdisAllocateFromNPagedLookasideList

NdisClRegisterSap

NdisMCmRegisterSapComplete

ProtocolClRegisterSapComplete

ProtocolCmRegisterSap