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) |