struktur IP_OFFLOAD_STATS (ndischimney.h)

Artikel
08/07/2023

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

Struktur IP_OFFLOAD_STATS berisi statistik yang disediakan target offload sebagai respons terhadap kueri OID_IP4_OFFLOAD_STATS atau OID_IP6_OFFLOAD_STATS.

Sintaks

typedef struct _IP_OFFLOAD_STATS {
  ULONG64 InReceives;
  ULONG64 InOctets;
  ULONG64 InDelivers;
  ULONG64 OutRequests;
  ULONG64 OutOctets;
  ULONG   InHeaderErrors;
  ULONG   InTruncatedPackets;
  ULONG   InDiscards;
  ULONG   OutDiscards;
  ULONG   OutNoRoutes;
} IP_OFFLOAD_STATS, *PIP_OFFLOAD_STATS;

Anggota

InReceives

Jumlah total datagram IP input yang telah diterima dari antarmuka pada koneksi TCP yang diturunkan, termasuk datagram IP yang diterima dalam kesalahan. Lihat "ipInReceives" di RFC 2011.

InOctets

Jumlah total oktet (byte) dalam datagram IP input yang telah diterima dari antarmuka pada koneksi TCP yang dibongkar. Oktet dari datagram yang dihitung dalam InReceives harus dihitung di sini. InOctets harus menyertakan jumlah byte di header IP dan payload.

InDelivers

Jumlah datagram IP input yang berhasil dikirimkan ke koneksi TCP yang dibongkar. Lihat "ipInDelivers" di RFC 2011.

OutRequests

Jumlah datagram IP yang disediakan target offload ke lapisan IP-nya dalam permintaan transmisi pada koneksi TCP yang dilepas. Lihat "ipOutRequests" di RFC 2011.

OutOctets

Jumlah total oktet (byte) dalam datagram IP yang disuplai target offload ke lapisan IP-nya dalam permintaan transmisi pada koneksi TCP yang dibongkar. Oktet dari datagram yang dihitung dalam OutRequests harus dihitung di sini. OutOctets harus menyertakan jumlah byte di header IP dan payload.

InHeaderErrors

Jumlah datagram IP input yang diterima pada koneksi TCP offload yang dibuang karena kesalahan di header IP mereka. Kesalahan tersebut termasuk checksum buruk, ketidakcocokan nomor versi, kesalahan format lainnya, time-to-live terlampaui, dan kesalahan yang ditemukan dalam memproses opsi IPv6 jika target offload mendukung opsi tersebut. (Target offload tidak memproses opsi IPv4.) Jumlah ini tidak termasuk kesalahan yang diakibatkan oleh alamat tujuan yang tidak valid. Lihat "ipInHdrErrors" di RFC 2011.

InTruncatedPackets

Jumlah datagram IP input yang dibuang karena bingkai datagram tidak membawa data yang cukup. InTruncatedPackets hanya boleh bertahap jika bingkai berisi header yang valid tetapi sebaliknya lebih pendek dari yang diperlukan. Bingkai yang terlalu pendek untuk memuat header yang valid harus dihitung sebagai InHeaderErrors .

InDiscards

Jumlah datagram IP input yang diterima pada koneksi TCP offload yang tidak berisi apa pun untuk mencegah pemrosesan lebih lanjut tetapi yang dibuang karena alasan run-time, seperti kurangnya memori yang tersedia atau sumber daya lainnya. Lihat "ipInDiscards" di RFC 2011.

OutDiscards

Jumlah datagram IP output yang disediakan target offload ke lapisan IP-nya yang tidak ada masalah yang dihadapi untuk mencegah transmisinya tetapi itu dibuang karena alasan run-time, seperti kurangnya memori atau sumber daya lainnya. Lihat "ipOutDiscards" di RFC 2011.

OutNoRoutes

Jumlah datagram IP output yang disediakan target offload ke lapisan IP-nya yang dibuang karena tidak ada rute (seperti objek status jalur yang dilepas) dapat ditemukan untuk mengirimkannya ke tujuan. Lihat "ipOutNoRoutes" di RFC 2011.

Keterangan

Statistik dalam struktur IP_OFFLOAD_STATS hanya berkaitan dengan datagram IP yang telah diproses target offload pada koneksi TCP yang dibongkar. Target offload tidak boleh menyertakan hitungan untuk datagram IP pada koneksi yang tidak dilepas. Statistik berkaitan dengan satu antarmuka jaringan.

Jika target offload memiliki beberapa antarmuka jaringan, target tersebut harus mempertahankan statistik offload IP terpisah untuk setiap antarmuka jaringan. Jika target offload mendukung koneksi IPv4 dan IPv6 untuk antarmuka jaringan, target tersebut harus mempertahankan satu set penghitung statistik offload IPv4 dan serangkaian penghitung statistik offload IPv6 lainnya untuk antarmuka jaringan tersebut.

Jika kemampuan cerobong TCP target offload diaktifkan (lihat NDIS_TASK_OFFLOAD) dan jika setidaknya satu objek status tetangga telah diturunkan ke target offload, target offload dapat memproses paket yang diterima yang memiliki header IP rusak dengan salah satu dari dua cara:

Target offload dapat menunjukkan paket melalui antarmuka non-offload dengan memanggil Fungsi NdisMIndicateReceiveNetBufferLists . Dalam hal ini, target offload tidak boleh menaikkan penghitung InHeaderErrors. Ini adalah pendekatan yang direkomendasikan.
Atau, target offload dapat menghilangkan NDIS_TASK_OFFLOAD paket yang rusak dan menaikkan penghitung InHeaderErrors.

Tumpukan host mengintegrasikan statistik yang dikembalikan oleh target offload dengan statistik yang dipertahankan tumpukan host untuk koneksi TCP yang tidak dibongkar.

Perhatikan bahwa tumpukan host memasok struktur IP_OFFLOAD_STATS saat mengatur OID_IP4_OFFLOAD_STATS atau OID_IP6_OFFLOAD_STATS. Namun, dalam kedua kasus, target offload tidak harus memeriksa nilai dalam struktur IP_OFFLOAD_STATS. Sebaliknya, ketika OID_IP4_OFFLOAD_STATS ditetapkan, target offload harus mengatur ulang semua penghitung statistik IPv4-nya untuk koneksi TCP yang dilepas. Ketika OID_IP6_OFFLOAD_STATS ditetapkan, target offload harus mengatur ulang semua penghitung statistik IPv6-nya untuk koneksi TCP yang dibongkar.

Semua penghitung yang menyediakan nilai untuk IP_OFFLOAD_STATS pembungkus struktur (mulai ulang dari nol) ketika bertambah melebihi jumlah maksimumnya.