QUERY_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/26/2024

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

NDIS ruft die ProtocolQueryOffloadComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Abfrageauslagerungsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisQueryOffload-Funktion initiiert hat.

Syntax

QUERY_OFFLOAD_COMPLETE_HANDLER QueryOffloadCompleteHandler;

void QueryOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] ProtocolBindingContext

Ein Handle zu einem Kontextbereich, der vom Protokolltreiber zugeordnet wird. Der Treiber verwaltet die Kontextinformationen pro Bindung in diesem Kontextbereich. Der Treiber hat dieses Handle für NDIS bereitgestellt, als der Treiber die NdisOpenAdapterEx-Funktion aufgerufen hat.

[in] OffloadBlockList

Ein Zeiger auf eine 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 den Zustand, der abgefragt oder abgefragt werden soll.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Auslagerungsziels oder eines zwischengeschalteten Treibers an den NdisMQueryOffloadStateComplete-Funktion , NDIS ruft die ProtocolQueryOffloadComplete-Funktion des überlagernden Protokolltreibers oder zwischengeschalteten Treibers auf.

Ein Zwischentreiber muss den Abschluss des Abfrageauslagerungsvorgangs an den Treiber darüber weitergeben, indem NdisMQueryOffloadStateComplete aufgerufen wird. Weitere Informationen finden Sie unter Weitergabe des Abschlusses eines State-Manipulation Vorgangs.

Aus der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur, die an seine ProtocolQueryOffloadComplete-Funktion übergeben wurde, erstellt der Zwischentreiber eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur. Weitere Informationen finden Sie unter Wiederverwenden einer NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur. Beim Aufrufen der NdisMQueryOffloadStateComplete-Funktion übergibt der Zwischentreiber einen Zeiger (den OffloadBlockList-Parameter ) auf diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur.