W_INVALIDATE_OFFLOAD_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
02/29/2024

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

Fungsi MiniportInvalidateOffload membatalkan objek status cerobong asap TCP yang sebelumnya diturunkan.

Sintaks

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

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

Parameter

[in] MiniportAdapterContext

Handel ke area konteks yang dialokasikan target offload tempat 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 tidak valid.

Nilai kembali

Tidak ada

Keterangan

Fungsi MiniportInvalidateOffload menyimpan penunjuk OffloadBlockList lalu mengembalikan. Target offload selalu menyelesaikan operasi yang tidak valid secara asinkron dengan memanggil NdismInvalidateOffloadComplete.

Pohon yang diteruskan ke fungsi MiniportInvalidateOffload hanya berisi struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Pohon tidak berisi struktur status offload. Artinya, tidak ada struktur seperti itu mengikuti struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dalam memori.

Struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di pohon menunjukkan objek status tidak valid. Anggota non-NULL *MiniportOffloadContext menunjuk ke lokasi memori yang berisi nilai PVOID yang disediakan oleh target offload saat objek status dilepas. Untuk informasi selengkapnya, lihat Menyimpan dan Mereferensikan Status Terbongkar. Nilai PVOID ini mereferensikan konteks offload miniport di mana target offload menyimpan objek status yang akan dibatalkan.

Untuk informasi tentang perlakuan offload target terhadap objek status yang tidak valid, lihat Perawatan Objek Status Tidak Valid.

Akhirnya, tumpukan host akan mengakhiri offload objek status yang tidak valid. Namun, sampai waktu tersebut, target offload memiliki objek status yang tidak valid. Target offload tidak boleh membebaskan sumber daya untuk objek status yang tidak valid sampai tumpukan host menghentikan offload objek status tersebut. Target offload tidak boleh menggunakan objek status yang tidak valid atau koneksi TCP apa pun yang bergantung pada objek status tersebut untuk mengirim data.