NDIS_SET_NET_BUFFER_LIST_CANCEL_ID Makro (ndis.h)

Artikel
02/29/2024

Das makro NDIS_SET_NET_BUFFER_LIST_CANCEL_ID markiert eine NET_BUFFER_LIST-Struktur mit einem Abbruchbezeichner, den ein Treiber später verwenden kann, um die ausstehende Übertragung der zugeordneten Daten abzubrechen.

Syntax

void NDIS_SET_NET_BUFFER_LIST_CANCEL_ID(
   _NBL,
   _CancelId
);

Parameter

_NBL

Ein Zeiger auf eine NET_BUFFER_LIST-Struktur .

_CancelId

Ein ULONG-Wert, der ein Abbruchbezeichner für die NET_BUFFER_LIST-Struktur ist.

Rückgabewert

Keine

Bemerkungen

Ein NDIS-Treiber kann das NDIS_SET_NET_BUFFER_LIST_CANCEL_ID-Makro für jede NET_BUFFER_LIST-Struktur aufrufen, die er für die Übertragung an Treiber auf niedrigerer Ebene übergibt. Das NDIS_SET_NET_BUFFER_LIST_CANCEL_ID-Makro markiert die angegebene NET_BUFFER_LIST-Struktur mit einem Abbruchbezeichner. Treiber müssen die NdisGeneratePartialCancelId-Funktion aufrufen, um einen Wert zu erhalten, den der Treiber als hohes Ordnungsbyte eines Abbruchbezeichners verwenden muss.

Um Sendeanforderungen abzubrechen, rufen Filtertreiber die Funktion NdisFCancelSendNetBufferLists auf . Andere Treiber rufen die NdisCancelSendNetBufferLists-Funktion auf.

Treiber können das makro NDIS_GET_NET_BUFFER_LIST_CANCEL_ID aufrufen, um einen Abbruchbezeichner aus einer NET_BUFFER_LIST-Struktur abzurufen.