NdisQueryOffloadState-Funktion (ndischimney.h)

Artikel
02/26/2024

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

Ein Protokoll- oder Zwischentreiber ruft die NdisQueryOffloadState-Funktion auf, um zuvor entladene TCP-Schornsteinzustandsobjekte abzufragen.

Syntax

void NdisQueryOffloadState(
  [in] IN NDIS_HANDLE                       NdisBindingHandle,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
);

Parameter

[in] NdisBindingHandle

Das Handle, das NDIS am NdisBindingHandle-Parameter von NdisOpenAdapterEx bereitgestellt hat. Mit diesem Handle wird die Bindung zwischen dem Aufrufer und dem zugrunde liegenden Zwischentreiber oder -auslagerungsziel identifiziert.

[in] OffloadBlockList

Ein Zeiger auf einen NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die eine eigenständige Struktur oder der Stamm einer verknüpften Liste solcher Strukturen sein kann. Diese Strukturen identifizieren die abgeladenen Zustandsobjekte, die abgefragt werden.

Rückgabewert

Keine

Bemerkungen

Ein Zwischentreiber ruft die NdisQueryOffloadState-Funktion auf, um einen Abfrageauslagerungsvorgang weiterzuverbreiten, der vom Hoststapel initiiert wurde. Weitere Informationen finden Sie unter Verteilen von State-Manipulation Vorgängen.

Aus der NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur, die an die Funktion MiniportQueryOffload übergeben wurde, erstellt der Zwischentreiber eine NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur. Weitere Informationen finden Sie unter Wiederverwenden eines NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur. Der Zwischentreiber übergibt einen Zeiger (den Parameter OffloadBlockList ) an diese NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, wenn die NdisQueryOffloadState-Funktion aufgerufen wird.