PROTOCOL_CL_DROP_PARTY_COMPLETE回调函数 (ndis.h)

ProtocolClDropPartyComplete 函数由设置多点连接的面向连接的 NDIS 客户端使用。 此类客户端必须具有 ProtocolClDropPartyComplete 函数才能完成其启动的异步操作

NdisClDropParty。 否则,此类协议驱动程序的已注册 ProtocolClDropPartyComplete 函数只需返回控制权。

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

语法

PROTOCOL_CL_DROP_PARTY_COMPLETE ProtocolClDropPartyComplete;

void ProtocolClDropPartyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE ProtocolPartyContext
)
{...}

参数

[in] Status

指定客户端启动的删除方操作的最终状态,可以是下列操作之一:

NDIS_STATUS_SUCCESS

该党已被撤销。 表示此方(客户端存储在 ProtocolPartyContext 区域中)的 NdisPartyHandle 现在无效。

NDIS_STATUS_FAILURE

给定方是客户端多点 VC 的最后一个剩余方。 因此,客户端应调用 NdisCloseCall 来删除此方。

[in] ProtocolPartyContext

指定客户端的按方上下文区域的句柄,客户端最初在调用 NdisClAddPartyNdisClMakeCall 时提供给 NDIS。

返回值

备注

ProtocolClDropPartyComplete 的调用指示调用管理器已完成对客户端上一次调用 NdisClDropParty 发起的请求的处理。 ProtocolClDropPartyComplete 可以释放客户端分配的按方上下文区域,或准备在后续调用 NdisClAddParty 中重复使用。

如果客户端正在将其创建的多点 VC 拆毁,ProtocolClDropPartyComplete 可将具有任何有效 NdisPartyHandle 的 NdisClDropPartyPartyParty 调用客户端的活动多点 VC 上的一个剩余方。 如果只有一个方保留在其多点 VC 上,则客户端应通过将 NdisPartyHandle 传递给 NdisClCloseCall 来删除该方。

示例

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

例如,若要定义名为“ MyClDropPartyComplete”的 ProtocolClDropPartyComplete 函数,请使用 PROTOCOL_CL_DROP_PARTY_COMPLETE 类型,如以下代码示例所示:

PROTOCOL_CL_DROP_PARTY_COMPLETE MyClDropPartyComplete;

然后,按如下所示实现函数:

_Use_decl_annotations_
VOID
 MyClDropPartyComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  ProtocolPartyContext
    )
  {...}

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

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

要求

   
最低受支持的客户端 支持 NDIS 6.0 和 NDIS 5.1 驱动程序, (请参阅 Windows Vista 中的 ProtocolClDropPartyComplete (NDIS 5.1) ) 。 支持 NDIS 5.1 驱动程序 (请参阅 Windows XP 中的 ProtocolClDropPartyComplete (NDIS 5.1) ) 。
目标平台 Windows
标头 ndis.h (包括 Ndis.h)
IRQL <= DISPATCH_LEVEL

另请参阅

NdisClAddParty

NdisClCloseCall

NdisClDropParty

NdisClMakeCall

NdisCmDropPartyComplete

NdisFreeMemory

NdisFreeToNPagedLookasideList

NdisMCmDropPartyComplete

ProtocolCmDropParty