NdisGeneratePartialCancelId 函式 (ndis.h)

  • 發行項

NdisGeneratePartialCancelId 函式會傳回呼叫驅動程序必須使用的值做為取消標識符的高序位元組。

Syntax

UCHAR NdisGeneratePartialCancelId();

傳回值

NdisGeneratePartialCancelId 會傳回呼叫驅動程式用來作為取消標識符高序位元組的值。

備註

藉由呼叫 來標記傳送 NET_BUFFER_LIST 結構與取消標識碼之前 NDIS_SET_NET_BUFFER_LIST_CANCEL_ID 宏，驅動程序應該呼叫 NdisGeneratePartialCancelId 一或多次。 NdisGeneratePartialCancelId 會傳回一個值，呼叫端驅動程式可以使用作為取消標識符的高序位元組。 在取消標識符前面加上 NdisGeneratePartialCancelId 所傳回的值，可確保取消標識符不會是本機電腦中另一個驅動程式指派的取消標識子重複專案。

一般而言，過度使用的驅動程式會在初始化順序期間呼叫 NdisGeneratePartialCancelId 一或多次，並儲存傳回的值或值以供稍後使用。 例如，通訊協定驅動程式可能會針對每個用戶端呼叫 NdisGeneratePartialCancelId 一次 (，例如 DHCP 或 ARC) 支援。 通訊協定驅動程式可以呼叫 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)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_Miscellaneous_Function (ndis)

另請參閱

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists