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