TCP_OFFLOAD_RECV_COMPLETE_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
02/26/2024

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

NDIS memanggil protokol atau fungsi ProtocolTcpOffloadReceiveComplete driver menengah untuk menyelesaikan operasi penerimaan yang sebelumnya dimulai driver dengan memanggil fungsi NdisOffloadTcpReceive .

Sintaks

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

void TcpOffloadRecvCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] ProtocolBindingContext

Handel ke area konteks yang dialokasikan oleh driver protokol. Driver mempertahankan informasi konteks per pengikatan di area konteks ini. Driver menyediakan handel ini ke NDIS ketika driver memanggil fungsi NdisOpenAdapterEx .

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST . Struktur ini bisa berdiri sendiri atau struktur pertama dalam daftar struktur NET_BUFFER_LIST yang ditautkan. Driver menyediakan pointer ini sebagai parameter input dalam panggilan sebelumnya ke Fungsi NdisOffloadTcpReceive .

Nilai kembali

Tidak ada

Keterangan

Menanggapi panggilan target driver atau offload yang mendasar ke Fungsi NdisOffloadTcpReceiveComplete , NDIS memanggil fungsi ProtocolTcpOffloadReceiveComplete driver protokol yang terlalu berlebihan atau driver menengah ProtocolTcpOffloadReceiveComplete .

Untuk menyebarluaskan penyelesaian operasi I/O ke driver yang terlalu berlebihan, driver perantara itu sendiri memanggil fungsi NdisOffloadTcpReceiveComplete , meneruskan hal berikut:

ProtocolBindingContext, yang merupakan handel yang secara unik mengidentifikasi driver perantara.
Penunjuk PNET_BUFFER_LIST yang diteruskan NDIS ke fungsi ProtocolTcpOffloadReceiveComplete driver menengah.

Sebagai respons, NDIS memanggil fungsi ProtocolTcpOffloadReceiveComplete driver yang terlalu berlebihan, meneruskan handel ProtocolBindingContext dan penunjuk PNET_BUFFER_LIST yang disediakan oleh driver perantara ke fungsi NdisOffloadTcpReceiveComplete .