Fungsi NdisMOffloadEventIndicate (ndischimney.h)

Artikel
02/29/2024

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

Target offload memanggil fungsi NdisMOffloadEventIndicate untuk menunjukkan berbagai peristiwa ke tumpukan host.

Sintaks

void NdisMOffloadEventIndicate(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList,
  [in] IN ULONG                             IndicationCode
);

Parameter

[in] NdisMiniportHandle

Handel yang diperoleh target offload dalam panggilan sebelumnya ke NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Penunjuk ke NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struktur. Struktur ini mengidentifikasi objek status yang dilepas di mana indikasi sedang dibuat. Perhatikan bahwa hanya ada satu struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Tidak ada daftar tertaut dari struktur tersebut.

Target offload memasok penunjuk OffloadBlockList yang valid saat membuat indikasi NeighborReachabilityQuery . Dalam hal ini, target offload memasok struktur NEIGHBOR_OFFLOAD_STATE_CONST , a NEIGHBOR_OFFLOAD_STATE_CACHED struktur, dan NEIGHBOR_OFFLOAD_STATE_DELEGATED struktur (dalam urutan tersebut) segera mengikuti struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang direferensikan oleh penunjuk OffloadBlockList .

Target offload harus menginisialisasi anggota berikut dari struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang diteruskannya ke fungsi NdisMOffloadEventIndicate :

Semua anggota struktur NDIS_OBJECT_HEADER, termasuk Jenis, Revisi, dan Ukuran . Target offload harus menginisialisasi Jenis ke NeighborOffloadState.
Penunjuk NextBlock ke nilai non-NULL jika ada blok berikutnya; jika tidak, ke NULL.
Penunjuk DependentBlockList ke NULL.
Anggota Status untuk NDIS_STATUS_SUCCESS.

Target offload tidak harus menginisialisasi anggota lain dari struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Untuk semua indikasi selain indikasi NeighborReachabilityQuery , target offload memasok pointer OffloadBlockList yaitu NULL.

[in] IndicationCode

Peristiwa yang ditunjukkan ditentukan sebagai salah satu nilai INDICATE_OFFLOAD_EVENT berikut:

NeighborReachabilityQuery

Menunjukkan bahwa entri cache tetangga (NCE) telah menjadi basi. Untuk informasi selengkapnya tentang NCEs, lihat RFC 2461.

NeighborReachabilityInDoubt

Dicadangkan.

Nilai kembali

Tidak ada

Keterangan

Tumpukan host menggunakan indikasi NeighborReachabilityQuery untuk mendeteksi ketidaktercapaian tetangga untuk IPv4 dan IPv6. Untuk deskripsi terperinci tentang indikasi ini, lihat Membuat Indikasi NeighborReachabilityQuery.