W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
08/07/2023

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

NDIS memanggil fungsi MiniportTcpOffloadReceiveReturn untuk mengembalikan kepemilikan NET_BUFFER_LIST dan struktur terkait ke target offload.

Sintaks

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] MiniportAdapterContext

Handel ke area konteks yang dialokasikan target offload tempat target offload mempertahankan informasi status tentang instans adaptor ini. Driver miniport menyediakan handel ini ke NDIS ketika dipanggil NdisMSetMiniportAttributes dari Fungsi MiniportInitializeEx .

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST . Struktur ini bisa menjadi struktur yang berdiri sendiri atau struktur pertama dalam daftar struktur NET_BUFFER_LIST yang ditautkan. Daftar tertaut dapat berisi struktur NET_BUFFER_LIST dari satu atau beberapa panggilan ke Fungsi NdisTcpOffloadReceiveHandler .

Nilai kembali

Fungsi MiniportTcpOffloadReceiveReturn harus selalu berhasil. Oleh karena itu, fungsi MiniportTcpOffloadReceiveReturn harus selalu mengembalikan NDIS_STATUS_SUCCESS.

Keterangan

NDIS memanggil fungsi MiniportTcpOffloadReceiveReturn untuk mengembalikan kepemilikan struktur NET_BUFFER_LIST dan struktur terkait yang diteruskan target offload dalam satu atau beberapa panggilan sebelumnya ke Fungsi NdisTcpOffloadReceiveHandler .

Fungsi MiniportTcpOffloadReceiveReturn dapat menyiapkan struktur NET_BUFFER_LIST yang dikembalikan untuk digunakan dalam indikasi terima berikutnya. Meskipun fungsi MiniportTcpOffloadReceiveReturn dapat mengembalikan struktur NET_BUFFER_LIST ke kumpulan (misalnya, fungsi NdisFreeNetBufferList dapat lebih efisien untuk menggunakan kembali struktur tanpa mengembalikannya ke kumpulan.

Perhatikan bahwa driver target offload tidak boleh membongkar dan adaptor target offload tidak boleh ditutup sampai semua buffer penerima yang ditunjukkan telah dikembalikan.