NdisMOffloadEventIndicate-Funktion (ndischimney.h)

Artikel
02/29/2024

[Das TCP-Chimney-Auslagerungsfeature ist veraltet und sollte nicht verwendet werden.]

Ein Auslagerungsziel ruft die NdisMOffloadEventIndicate-Funktion auf, um verschiedene Ereignisse für den Hoststapel anzugeben.

Syntax

void NdisMOffloadEventIndicate(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList,
  [in] IN ULONG                             IndicationCode
);

Parameter

[in] NdisMiniportHandle

Das Handle, das das Auslagerungsziel in einem vorherigen Aufruf erhalten hat NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Ein Zeiger auf einen NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur. Diese Struktur identifiziert das ausgeladene Zustandsobjekt, für das die Angabe gemacht wird. Beachten Sie, dass es nur eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur gibt. Es gibt keine verknüpfte Liste solcher Strukturen.

Das Auslagerungsziel stellt einen gültigen OffloadBlockList-Zeiger bereit, wenn eine NeighborReachabilityQuery-Anzeige erstellt wird. In diesem Fall liefert das Auslagerungsziel einen NEIGHBOR_OFFLOAD_STATE_CONST Struktur NEIGHBOR_OFFLOAD_STATE_CACHED Struktur und eine NEIGHBOR_OFFLOAD_STATE_DELEGATED Struktur (in dieser Reihenfolge) unmittelbar nach der NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, auf die der OffloadBlockList-Zeiger verweist.

Ein Auslagerungsziel muss die folgenden Member einer NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur initialisieren, die es an die NdisMOffloadEventIndicate-Funktion übergibt:

Alle Member der NDIS_OBJECT_HEADER-Struktur, einschließlich Type, Revision und Size . Das Auslagerungsziel muss Type in NeighborOffloadState initialisieren.
Der NextBlock-Zeiger auf einen Nicht-NULL-Wert , wenn ein nächster Block vorhanden ist; andernfalls auf NULL.
Der DependentBlockList-Zeiger auf NULL.
Das Statusmitglied , das NDIS_STATUS_SUCCESS soll.

Das Auslagerungsziel muss keine anderen Member der NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur initialisieren.

Für alle anderen Indikationen als die NeighborReachabilityQuery-Indikation stellt das Auslagerungsziel einen OffloadBlockList-Zeigermit NULL bereit.

[in] IndicationCode

Das angegebene Ereignis wird als einer der folgenden INDICATE_OFFLOAD_EVENT Werte angegeben:

NeighborReachabilityQuery

Gibt an, dass ein benachbarter Cacheeintrag (NCE) veraltet ist. Weitere Informationen zu NCEs finden Sie unter RFC 2461.

NeighborReachabilityInDoubt

Reserviert.

Rückgabewert

Keine

Bemerkungen

Der Hoststapel verwendet die Anzeige NeighborReachabilityQuery , um die Unerreichbarkeit von Nachbarn für IPv4 und IPv6 zu erkennen. Eine ausführliche Beschreibung dieser Angabe finden Sie unter Making a NeighborReachabilityQuery Indication.