NdisGeneratePartialCancelId 函数 (ndis.h)

  • 项目

NdisGeneratePartialCancelId 函数返回一个值，调用驱动程序必须使用该值作为取消 ID 的高阶字节。

语法

UCHAR NdisGeneratePartialCancelId();

返回值

NdisGeneratePartialCancelId 返回一个值，调用驱动程序使用该值作为取消 ID 的高阶字节。

注解

使用取消 ID 标记发送 NET_BUFFER_LIST 结构之前，请调用 NDIS_SET_NET_BUFFER_LIST_CANCEL_ID 宏，驱动程序应调用 NdisGeneratePartialCancelId 一次或多次。 NdisGeneratePartialCancelId 返回一个值，调用驱动程序可以使用该值作为取消 ID 的高序字节。 使用 NdisGeneratePartialCancelId 返回的值为取消 ID 添加前缀可确保取消 ID 不会是本地计算机中另一个驱动程序分配的取消 ID 的副本。

通常，过度分配的驱动程序在其初始化序列期间调用 NdisGeneratePartialCancelId 一次或多次，并存储返回的值供以后使用。 例如，协议驱动程序可以为它支持的每个客户端 (（例如 DHCP 或 ARC) ）调用 一次 NdisGeneratePartialCancelId 。 协议驱动程序可以调用 NdisCancelSendNetBufferLists 函数稍后用于取消发送请求。 在这种情况下，NDIS 调用取消发送函数 (例如 ，基础驱动程序的 MiniportCancelSend) 。

要求

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

另请参阅

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists