W_UPDATE_OFFLOAD_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
08/07/2023

[Fitur offload cerobong asap TCP tidak digunakan lagi dan tidak boleh digunakan.]

Fungsi MiniportUpdateOffload memperbarui objek status cerobong asap TCP yang sebelumnya dilepas.

Sintaks

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] MiniportAdapterContext

Handel ke area konteks offload yang dialokasikan target di mana target offload mempertahankan informasi status tentang instans adaptor ini. Target offload memberikan handel ini ke NDIS ketika dipanggil NdisMSetMiniportAttributes dari Fungsi MiniportInitializeEx .

[in] OffloadBlockList

Penunjuk ke NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struktur, yang dapat menjadi akar dari daftar tertaut struktur tersebut. Struktur ini mengidentifikasi objek status terbongkar yang sedang diperbarui. Hanya variabel yang di-cache yang diperbarui.

Nilai kembali

Tidak ada

Keterangan

Hanya variabel yang di-cache yang diperbarui.

Fungsi MiniportUpdateOffload menyimpan handel MiniportAdapterContext dan penunjuk OffloadBlockList lalu kembali. Target offload selalu menyelesaikan operasi pembaruan secara asinkron dengan memanggil Fungsi NdisMUpdateOffloadComplete . Penunjuk OffloadBlockList menunjuk ke struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang dapat berupa struktur yang berdiri sendiri atau daftar blok akar dalam pohon status offload yang berisi beberapa struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Daftar blok tersebut, serta struktur status offload apa pun yang terkait dengannya, berlaku sampai driver miniport memanggil Fungsi NdisMUpdateOffloadComplete .

Sebelum fungsi MiniportUpdateOffload kembali, target offload menggunakan pohon status offload yang diteruskan ke fungsi MiniportUpdateOffload untuk memperbarui status offload:

Target offload menyalin nilai variabel dari struktur status apa pun di pohon ke objek status terbongkar yang sesuai. Hanya variabel CACHED yang diperbarui.
Pohon mungkin menunjukkan bahwa tautan jalur-ke-tetangga harus diperbarui. Untuk informasi selengkapnya, lihat Menautkan Objek Status Jalur ke Objek Status Tetangga Baru. Dalam hal ini, target offload harus memperbarui representasi internal status offload untuk mencerminkan tautan yang diperbarui.