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