PROTOCOL_CM_DEREGISTER_SAP回调函数（ndis.h）

需要 ProtocolCmDeregisterSap 函数。 NDIS 调用此函数以请求调用管理器代表面向连接的客户端取消注册 SAP。

注释必须使用 PROTOCOL_CM_DEREGISTER_SAP 类型声明函数。有关详细信息，请参阅以下示例部分。

语法

PROTOCOL_CM_DEREGISTER_SAP ProtocolCmDeregisterSap;

NDIS_STATUS ProtocolCmDeregisterSap(
  [in] NDIS_HANDLE CallMgrSapContext
)
{...}

参数

[in] CallMgrSapContext

指定调用管理器分配的上下文区域的句柄，其中调用管理器维护其每个 SAP 状态信息。调用管理器从 NDIS 向 NDIS 提供了此句柄 ProtocolCmRegisterSap 函数。

返回值

ProtocolCmDeregisterSap 返回其作的状态，如下所示之一：

返回代码	描述
NDIS_STATUS_SUCCESS	指示调用管理器已成功删除 SAP 注册，并释放分配的任何资源来维护每个 SAP 信息。
NDIS_STATUS_PENDING	指示调用管理器将完成以异步方式取消注册 SAP 的请求。呼叫管理器必须呼叫 NdisCmDeregisterSapComplete，以在作完成后向 NDIS 发出信号。

言论

ProtocolCmDeregisterSap 根据需要与网络控制设备或其他特定于媒体的代理通信，以取消注册网络上的 SAP。此类作可能包括，但包括但不限于：

与切换硬件通信
与网络控制站通信
与其他特定于媒体的网络代理通信

如果调用管理器需要与网络控制代理（如网络交换机）通信，则应使用与在其 ProtocolBindAdapterEx 函数中建立的网络控制代理的虚拟连接。独立呼叫管理器通过调用 NdisCoSendNetBufferLists来通过基础微型端口驱动程序进行通信。提供集成呼叫管理支持的微型端口驱动程序从不调用 NdisCoSendNetBufferLists。而是直接通过网络传输数据。

此外，ProtocolCmDeregisterSap 必须在其每个 SAP 区域中释放其每个 SAP 区域中的任何动态分配的资源，CallMgrSapContext，以及在将控制权返回到 NDIS 之前释放状态区域本身。

示例

若要定义 ProtocolCmDeregisterSap 函数，必须先提供一个函数声明来标识要定义的函数类型。 Windows 为驱动程序提供了一组函数类型。使用函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。

例如，若要定义名为“MyCmDeregisterSap”的 ProtocolCmDeregisterSap 函数，请使用 PROTOCOL_CM_DEREGISTER_SAP 类型，如以下代码示例所示：

PROTOCOL_CM_DEREGISTER_SAP MyCmDeregisterSap;

然后，按如下所示实现函数：

_Use_decl_annotations_
NDIS_STATUS
 MyCmDeregisterSap(
    NDIS_HANDLE  CallMgrSapContext
    )
  {...}

PROTOCOL_CM_DEREGISTER_SAP 函数类型在 Ndis.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 PROTOCOL_CM_DEREGISTER_SAP 函数类型的批注。有关函数声明要求的详细信息，请参阅使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅批注函数行为。

要求

要求	价值
最低支持的客户端	支持 NDIS 6.0 和 NDIS 5.1 驱动程序（请参阅 Windows Vista 中的 ProtocolCmDeregisterSap （NDIS 5.1）。支持 NDIS 5.1 驱动程序（请参阅 Windows XP 中的 ProtocolCmDeregisterSap （NDIS 5.1）。
目标平台	窗户
标头	ndis.h （包括 Ndis.h）
IRQL	<= DISPATCH_LEVEL