TCP_OFFLOAD_EVENT_HANDLER fungsi panggilan balik (ndischimney.h)

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

NDIS memanggil fungsi ProtocolIndicateOffloadEvent driver protokol atau driver menengah untuk memposting indikasi yang dimulai oleh panggilan target driver atau offload yang mendasar ke Fungsi NdisTcpOffloadEventHandler .

Sintaks

TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;

void TcpOffloadEventHandler(
  [in] IN PVOID OffloadContext,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

Parameter

[in] OffloadContext

Penunjuk ke protokol atau struktur NDIS_OFFLOAD_HANDLE driver perantara untuk koneksi TCP tempat indikasi sedang dibuat. Protokol atau driver perantara menyediakan pointer ini sebagai parameter input ke fungsi NdisInitiateOffload saat membongkar koneksi.

[in] EventType

Peristiwa yang ditunjukkan sebagai salah satu nilai TCP_OFFLOAD_EVENT_TYPE berikut:

TcpIndicateDisconnect

Menunjukkan bahwa host jarak jauh memulai pemutusan sambungan dengan anggun dengan mengirim segmen FIN pada koneksi.

TcpIndicateRetrieve

Menunjukkan bahwa target offload meminta tumpukan host untuk mengakhiri offload koneksi TCP.

TcpIndicateAbort

Menunjukkan bahwa host jarak jauh memulai pemutusan sambungan abortif dengan mengirim segmen RST yang dapat diterima pada koneksi.

TcpIndicateSendBacklogChange

Menunjukkan perubahan ukuran backlog kirim yang disukai.

[in] EventSpecificInformation

Menentukan informasi tambahan tentang peristiwa yang ditunjukkan sebagai berikut:

TcpIndicateDisconnect

Tidak berarti.

TcpIndicateRetrieve

Menunjukkan alasan permintaan unggahan sebagai nilai TCP_UPLOAD_REASON. Untuk mengetahui informasi selengkapnya, lihat NdisTcpOffloadEventHandler.

TcpIndicateAbort

Tidak berarti.

TcpIndicateSendBacklogChange

Menentukan jumlah optimal byte kirim data yang harus memiliki tumpukan host yang luar biasa pada target offload untuk mencapai throughput data terbaik.

Mengembalikan nilai

Tidak ada

Keterangan

Untuk menyebarkan indikasi ke driver atau tumpukan host yang terlalu berlebihan, driver perantara memanggil fungsi NdisTcpOffloadEventHandler . Driver perantara meneruskan parameter berikut ke
Fungsi NdisTcpOffloadEventHandler :

  • NdisOffloadHandle bahwa target offload disimpan dalam konteksnya untuk koneksi TCP yang dibongkar. Untuk mengetahui informasi selengkapnya, lihat Mereferensikan Status Terbongkar Melalui Driver Perantara.
  • EventType yang diteruskan NDIS ke fungsi ProtocolTcpOffloadEvent driver menengah.
  • EventSpecificInformation yang diteruskan NDIS ke fungsi ProtocolTcpOffloadEvent driver menengah.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header ndischimney.h (termasuk Ndischimney.h)

Lihat juga

NdisTcpOffloadEventHandler