NdisMGetOffloadHandlers-Funktion (ndischimney.h)

Artikel
02/07/2025

[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]

Diese Funktion ruft die Einstiegspunkte der NDIS-Funktionen für einen bestimmten Schornsteintyp ab.

Syntax

NDIS_STATUS NdisMGetOffloadHandlers(
  [in]  IN NDIS_HANDLE                   NdisMiniportHandle,
  [in]  IN NDIS_CHIMNEY_OFFLOAD_TYPE     ChimneyType,
  [out] OUT PNDIS_OFFLOAD_EVENT_HANDLERS *OffloadHandlers
);

Parameter

[in] NdisMiniportHandle

Das Handle zu einem Kontextbereich, der dem Ziel zugeordnet ist, in dem das Offloadziel Statusinformationen zu dieser Instanz des Adapters verwaltet. Das offload-Ziel, das dieses Handle beim Aufrufen an NDIS übermittelt hat von NdisMSetMiniportAttributes MiniportInitializeEx Funktion.

[in] ChimneyType

Ein Schornsteintyp, der einer der folgenden NDIS_CHIMNEY_OFFLOAD_TYPE Werte ist:

NdisTcpChimneyOffload

Der TCP-Schornstein-Offloadtyp.

Alle anderen NDIS_CHIMNEY_OFFLOAD_TYPE Werte sind derzeit reserviert.

[out] OffloadHandlers

Ein Zeiger auf eine Variable, die vom Offloadziel bereitgestellt wird. Die Größe dieser Variablen ist sizeof(PNDIS_OFFLOAD_EVENT_HANDLERS). Wenn der Aufruf der NdisMGetOffloadHandlers Funktion erfolgreich ist, gibt die Funktion in dieser Variablen einen Zeiger auf eine NDIS_OFFLOAD_EVENT_HANDLERS Struktur zurück. Diese Struktur dient als Kopfzeile für die schornsteinspezifische Struktur, die die Einstiegspunkte enthält. Die NDIS_OFFLOAD_EVENT_HANDLERS Struktur ist wie folgt formatiert:

typedef struct _NDIS_OFFLOAD_EVENT_HANDLERS {
  NDIS_OBJECT_HEADER  Header;
} NDIS_OFFLOAD_EVENT_HANDLERS, *PNDIS_OFFLOAD_EVENT_HANDLERS;

Diese Struktur enthält das folgende Element:

Gibt einen NDIS-Objektheader an, der als NDIS_OBJECT_HEADER Struktur formatiert ist.

Rückgabewert

NdisMGetOffloadHandlers können eine der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Aufruf war erfolgreich. Die zurückgegebenen NDIS-Einstiegspunkte sind für den angegebenen Schornsteintyp gültig.
STATUS_NOT_SUPPORTED	NDIS unterstützt nicht den vom Offloadziel angegebenen Schornsteintyp. In diesem Fall gibt NDIS keinen gültigen OffloadHandlers Zeiger zurück.

Bemerkungen

Das Offload-Ziel ruft diese Funktion aus der MiniportInitializeEx--Funktion auf, um die Einstiegspunkte der NDIS-Funktionen für einen bestimmten Schornsteintyp abzurufen. Das Offload-Ziel ruft NdisMGetOffloadHandlers einmal für jeden unterstützten Schornsteintyp. In jedem Anruf gibt das Offloadziel einen anderen Schornsteintyp an.

Wenn der Aufruf der NdisMGetOffloadHandlers Funktion erfolgreich ist, stellt NDIS einen gültigen OffloadHandlers Zeiger bereit, der auf eine NDIS_OFFLOAD_EVENT_HANDLERS Struktur verweist. Diese Struktur enthält eine NDIS_OBJECT_HEADER Struktur. Das Offloadziel untersucht die Elemente Type, Revisionund Size Member der NDIS_OBJECT_HEADER Struktur. Diese Member geben die Struktur an, die die schornsteinspezifischen Einstiegspunkte, die Revisionsnummer dieser Struktur und die Größe dieser Struktur in Byte enthält. Der Wert Type ist derselbe Wert wie der offload-Zielwert, der für den ChimneyType-Parameter angegeben wird.

Wenn das Offload-Ziel die angegebene Revision Zahl unterstützt, wandelt es die OffloadHandlers Zeiger auf einen Zeiger auf den entsprechenden Schornstein-spezifischen Strukturtyp um. Die folgende Tabelle gibt die Schornstein-spezifische Struktur für jeden Schornsteintyp an.

ChimneyType	Schornstein-spezifische Handlernstruktur
NdisTcpChimneyOffload	NDIS_TCP_OFFLOAD_EVENT_HANDLERS

For example, for the NdisTcpChimneyOffload chimney type, the offload target casts the OffloadHandlers zeiger to *PNDIS_TCP_OFFLOAD_EVENT_HANDLERS.

Die Schornstein-spezifische Handlerstruktur enthält dieselbe NDIS_OBJECT_HEADER Struktur wie die NDIS_OFFLOAD_EVENT_HANDLERS Struktur.

Das Offloadziel kopiert die Einstiegspunkte aus der schornsteinspezifischen Struktur in eine eigene interne Datenstruktur und gibt dann zurück.