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