QUERY_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)
[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]
NDIS ruft die ProtocolQueryOffloadComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Abfrageausladevorgang 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 zugewiesen wird. Der Treiber behält die Informationen zu bindungskontextbezogenen Informationen in diesem Kontextbereich bei. Der Treiber hat diesen Handle an NDIS übergeben, wenn der Treiber die NdisOpenAdapterEx--Funktion aufgerufen hat.
[in] OffloadBlockList
Ein Zeiger auf einen NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die eine eigenständige Struktur oder die Wurzel einer verknüpften Liste solcher Strukturen sein kann. Diese Strukturen identifizieren den zustand, der abgefragt wurde oder der versucht wurde, abgefragt zu werden.
Rückgabewert
Nichts
Bemerkungen
Als Reaktion auf den Aufruf eines zugrunde liegenden Offloadziels oder eines zwischengeschalteten Treibers an den NdisMQueryOffloadStateComplete-Funktion ruft NDIS die ProtocolQueryOffloadComplete-Funktion des überlagernden Protokolltreibers oder Zwischentreibers auf.
Ein Zwischentreiber muss den Abschluss des Abfrageoffloadvorgangs an den darüber liegenden Treiber weitergeben, indem NdisMQueryOffloadStateCompleteaufgerufen wird. Weitere Informationen finden Sie unter Weitergabe des Abschlusses eines State-Manipulation Operation.
Aus der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die an die ProtocolQueryOffloadComplete--Funktion übergeben wurde, erstellt der Zwischentreiber eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur. Weitere Informationen finden Sie unter Reusing an NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Structure. Beim Aufrufen der NdisMQueryOffloadStateComplete--Funktion übergibt der Zwischentreiber einen Zeiger (der OffloadBlockList Parameter) an diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | ndischimney.h (include Ndischimney.h) |