UPDATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)
[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]
NDIS ruft die ProtocolUpdateOffloadComplete--Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Update-Offloadvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisUpdateOffload-Funktion initiiert hat.
Syntax
UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;
void UpdateOffloadCompleteHandler(
[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 Status, der aktualisiert wurde oder der versucht wurde, aktualisiert zu werden.
Rückgabewert
Nichts
Bemerkungen
Als Reaktion auf den Aufruf eines zugrunde liegenden Offloadziels oder eines zwischengeschalteten Treibers an den NdisMUpdateOffloadComplete--Funktion ruft NDIS die ProtocolUpdateOffloadComplete--Funktion eines Protokoll- oder Zwischentreibers auf.
Ein Zwischentreiber muss den Abschluss des Update-Offloadvorgangs an den darüber liegenden Treiber weitergeben, indem NdisMUpdateOffloadCompleteaufgerufen wird. Weitere Informationen finden Sie unter Weitergabe des Abschlusses eines State-Manipulation Operation.
Aus der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die an die ProtocolUpdateOffloadComplete--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 NdisMUpdateOffloadComplete--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) |