struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO (ndis/nbllso.h)

Artikel
03/10/2023

Struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO menentukan informasi yang digunakan dalam membongkar tugas offload pengiriman besar (LSO) dari transportasi TCP/IP ke adaptor miniport. Struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO adalah bagian dari informasi NET_BUFFER_LIST .

Sintaks

typedef struct _NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO {
  union {
    struct {
      ULONG Unused : 30;
      ULONG Type : 1;
      ULONG Reserved2 : 1;
    } Transmit;
    struct {
      ULONG MSS : 20;
      ULONG TcpHeaderOffset : 10;
      ULONG Type : 1;
      ULONG Reserved2 : 1;
    } LsoV1Transmit;
    struct {
      ULONG TcpPayload : 30;
      ULONG Type : 1;
      ULONG Reserved2 : 1;
    } LsoV1TransmitComplete;
    struct {
      ULONG MSS : 20;
      ULONG TcpHeaderOffset : 10;
      ULONG Type : 1;
      ULONG IPVersion : 1;
    } LsoV2Transmit;
    struct {
      ULONG Reserved : 30;
      ULONG Type : 1;
      ULONG Reserved2 : 1;
    } LsoV2TransmitComplete;
    PVOID Value;
  };
} NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO, *PNDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO;

Anggota

Transmit

Struktur dalam NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO yang menentukan pengiriman informasi dan yang berisi anggota berikut:

Transmit.Unused

Nilai ULONG yang menentukan ruang yang tidak digunakan yang dicadangkan untuk NDIS.

Transmit.Type

Jenis offload yang harus dijalankan driver miniport. Driver protokol mengatur anggota ini ke NDIS_TCP_LARGE_SEND_OFFLOAD_V1_TYPE untuk menentukan operasi offload pengiriman besar versi 1 (LSOV1) atau ke NDIS_TCP_LARGE_SEND_OFFLOAD_V2_TYPE untuk menentukan operasi offload pengiriman besar versi 2 (LSOV2).

Transmit.Reserved2

Dicadangkan untuk NDIS.

LsoV1Transmit

Struktur dalam NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO yang menentukan informasi transmisi LSO dan yang berisi anggota berikut:

LsoV1Transmit.MSS

Ukuran segmen maksimum (MSS), dalam byte, untuk setiap paket setelah segmentasi. Transportasi TCP/IP menulis nilai ini sebelum meneruskan paket TCP besar ke driver miniport untuk segmentasi. Ukuran payload TCP di setiap segmen yang ditransmisikan tidak boleh melebihi nilai ini.

LsoV1Transmit.TcpHeaderOffset

Offset, dalam byte, header TCP dari awal paket untuk paket TCP. Driver Miniport dapat menggunakan TcpHeaderOffset untuk menentukan lokasi header TCP sehingga tidak perlu mengurai header IP.

LsoV1Transmit.Type

Jenis offload yang harus dijalankan driver miniport. Driver protokol mengatur anggota ini ke NDIS_TCP_LARGE_SEND_OFFLOAD_V1_TYPE untuk menentukan operasi LSOV1 atau ke NDIS_TCP_LARGE_SEND_OFFLOAD_V2_TYPE untuk menentukan operasi LSOV2.

LsoV1Transmit.Reserved2

Dicadangkan untuk NDIS.

LsoV1TransmitComplete

Struktur dalam NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO yang menentukan LSO mengirimkan informasi lengkap dan yang berisi anggota berikut:

LsoV1TransmitComplete.TcpPayload

Jumlah total byte payload TCP dalam satu set paket yang dibuat oleh kartu antarmuka jaringan (NIC) dengan mensegmentasi paket besar. Driver miniport menulis ukuran payload TCP sebelum menyelesaikan pengiriman paket LSO.

LsoV1TransmitComplete.Type

Jenis offload yang dilakukan driver miniport. Driver miniport meninggalkan nilai ini sama seperti ketika driver yang terlalu berlebihan mengirimkan paket untuk dikirimkan.

LsoV1TransmitComplete.Reserved2

Dicadangkan untuk NDIS.

LsoV2Transmit

Struktur dalam NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO yang menentukan LSOV2 mengirimkan informasi dan yang berisi anggota berikut:

LsoV2Transmit.MSS

MSS, dalam byte, untuk setiap segmen TCP. Transportasi TCP/IP menulis nilai ini sebelum meneruskan paket TCP besar ke driver miniport untuk segmentasi.

LsoV2Transmit.TcpHeaderOffset

Offset, dalam byte, header TCP dari awal paket untuk paket TCP. Driver Miniport dapat menggunakan TcpHeaderOffset untuk menentukan lokasi header TCP sehingga tidak perlu mengurai header IP.

LsoV2Transmit.Type

LsoV2Transmit.IPVersion

Versi IP paket. Untuk paket IPv4, IPVersion diatur ke NDIS_TCP_LARGE_SEND_OFFLOAD_IPv4. Untuk paket IPv6, IPVersion diatur ke NDIS_TCP_LARGE_SEND_OFFLOAD_IPv6.

LsoV2TransmitComplete

Struktur dalam NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO yang menentukan LSOV2 mengirimkan informasi lengkap dan yang berisi anggota berikut:

LsoV2TransmitComplete.Reserved

Secara umum, anggota ini dicadangkan untuk NDIS. Namun, ketika operasi pengiriman selesai, driver miniport harus mengatur anggota ini ke nol.

LsoV2TransmitComplete.Type

Jenis offload yang dilakukan driver miniport. Driver miniport meninggalkan nilai ini sama seperti ketika driver yang terlalu berlebihan mengirimkan paket untuk dikirimkan.

Misalnya, ketika operasi pengiriman selesai, driver miniport mengatur anggota ini ke NDIS_TCP_LARGE_SEND_OFFLOAD_V2_TYPE.

LsoV2TransmitComplete.Reserved2

Dicadangkan untuk NDIS.

Value

Versi PVOID dari informasi LSO. Gunakan anggota ini untuk mengakses informasi mentah alih-alih bidang tertentu.

Keterangan

Struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO menentukan informasi untuk operasi LSOV1 dan LSOV2. Struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO adalah bagian dari informasi yang disertakan dalam struktur NET_BUFFER_LIST .

Untuk mengatur dan mendapatkan informasi LSOV1 atau LSOV2, gunakan indeks TcpLargeSendNetBufferListInfo dengan makro NET_BUFFER_LIST_INFO . NET_BUFFER_LIST_INFO mengembalikan nilai ULONG (bukan penunjuk ke nilai ULONG).

Transportasi TCP/IP memperbarui anggota MSS dan TcpHeaderOffset dari struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO sebelum mengirim paket besar ke driver miniport.

Untuk LSOV1, driver miniport menulis ukuran payload TCP di anggota TcpPayload sebelum menyelesaikan operasi pengiriman untuk paket tersegmentasi.

Catatan Setiap struktur NET_BUFFER_LIST yang berisi informasi LSOv1 atau LSOv2 juga berisi struktur NET_BUFFER tunggal.