NDIS_SET_NET_BUFFER_LIST_CANCEL_ID宏 (ndis.h)

發行項
02/29/2024

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID宏會以取消標識符標示NET_BUFFER_LIST結構，讓驅動程式稍後可用來取消關聯數據的擱置傳輸。

語法

void NDIS_SET_NET_BUFFER_LIST_CANCEL_ID(
   _NBL,
   _CancelId
);

參數

_NBL

NET_BUFFER_LIST 結構的指標。

_CancelId

ULONG 值，這是 NET_BUFFER_LIST 結構的取消標識符。

傳回值

無

備註

NDIS 驅動程式可以針對傳遞至較低層級驅動程式的每個 NET_BUFFER_LIST 結構呼叫 NDIS_SET_NET_BUFFER_LIST_CANCEL_ID 宏。 NDIS_SET_NET_BUFFER_LIST_CANCEL_ID宏會使用取消標識符標記指定的NET_BUFFER_LIST結構。驅動程式必須呼叫 NdisGeneratePartialCancelId 函式，以取得驅動程式必須用來作為取消標識符高序位元組的值。

若要取消傳送要求，篩選驅動程式會呼叫 NdisFCancelSendNetBufferLists 函式。其他驅動程式會呼叫 NdisCancelSendNetBufferLists 函式。

驅動程式可以呼叫 NDIS_GET_NET_BUFFER_LIST_CANCEL_ID 宏，從 NET_BUFFER_LIST 結構擷取取消標識符。