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) |