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 调用基础驱动程序的 cancel send 函数(例如,MiniportCancelSend)。

要求

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

另请参阅

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists