NdisGeneratePartialCancelId 函式 (ndis.h)
NdisGeneratePartialCancelId 函式會傳回呼叫驅動程式必須作為取消標識符的高階位元組使用的值。
語法
UCHAR NdisGeneratePartialCancelId();
傳回值
NdisGeneratePartialCancelId 會傳回呼叫驅動程式用來作為取消標識符的高階位元組的值。
言論
在標記傳送具有取消標識符的 NET_BUFFER_LIST 結構之前,請呼叫 NDIS_SET_NET_BUFFER_LIST_CANCEL_ID 巨集,驅動程式應該呼叫 NdisGeneratePartialCancelId 一或多次。 NdisGeneratePartialCancelId 會傳回值,呼叫驅動程式可以使用做為取消標識符的高階位元組。 在取消標識符前面加上 NdisGeneratePartialCancelId 所傳回的值, 可確保取消標識符不會是本機計算機中另一個驅動程式指派的取消標識符複本。
一般而言,過度裝載的驅動程式會在初始化序列期間呼叫 NdisGeneratePartialCancelId 一或多次,並儲存傳回的值或值以供日後使用。 例如,通訊協定驅動程式可以針對支援的每個用戶端(例如 DHCP 或 ARC)呼叫 NdisGeneratePartialCancelId 一次。 通訊協定驅動程式可以呼叫 NdisCancelSendNetBufferLists 函式稍後取消傳送要求。 在此情況下,NDIS 會呼叫基礎驅動程式的 cancel send 函式(例如,MiniportCancelSend)。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 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) |