enumerasi NDIS_NET_BUFFER_LIST_INFO (ndis/nblinfo.h)

Artikel
08/07/2023

Enumerasi NDIS_NET_BUFFER_LIST_INFO mengidentifikasi informasi yang umum untuk semua struktur NET_BUFFER dalam struktur NET_BUFFER_LIST .

Sintaks

typedef enum _NDIS_NET_BUFFER_LIST_INFO {
  TcpIpChecksumNetBufferListInfo,
  TcpOffloadBytesTransferred,
  IPsecOffloadV1NetBufferListInfo,
  IPsecOffloadV2NetBufferListInfo,
  TcpLargeSendNetBufferListInfo,
  TcpReceiveNoPush,
  ClassificationHandleNetBufferListInfo,
  Ieee8021QNetBufferListInfo,
  NetBufferListCancelId,
  MediaSpecificInformation,
  NetBufferListFrameType,
  NetBufferListProtocolId,
  NetBufferListHashValue,
  NetBufferListHashInfo,
  WfpNetBufferListInfo,
  IPsecOffloadV2TunnelNetBufferListInfo,
  IPsecOffloadV2HeaderNetBufferListInfo,
  NetBufferListCorrelationId,
  NetBufferListFilteringInfo,
  MediaSpecificInformationEx,
  NblOriginalInterfaceIfIndex,
  NblReAuthWfpFlowContext,
  TcpReceiveBytesTransferred,
  NrtNameResolutionId,
  UdpRecvSegCoalesceOffloadInfo,
  SwitchForwardingReserved,
  SwitchForwardingDetail,
  VirtualSubnetInfo,
  IMReserved,
  TcpRecvSegCoalesceInfo,
  UdpSegmentationOffloadInfo,
  RscTcpTimestampDelta,
  TcpSendOffloadsSupplementalNetBufferListInfo,
  GftOffloadInformation,
  GftFlowEntryId,
  NetBufferListInfoReserved3,
  SwitchForwardingReserved,
  SwitchForwardingDetail_b0_to_b31,
  SwitchForwardingDetail_b32_to_b63,
  VirtualSubnetInfo,
  NetBufferListInfoReserved1,
  NetBufferListInfoReserved2,
  MaxNetBufferListInfo
} NDIS_NET_BUFFER_LIST_INFO, *PNDIS_NET_BUFFER_LIST_INFO;

Konstanta


`TcpIpChecksumNetBufferListInfo` Mengidentifikasi informasi checksum yang digunakan dalam membongkar tugas checksum dari protokol TCP/IP ke pengemudi miniport. Kapan TcpIpChecksumNetBufferListInfo ditentukan, makro NET_BUFFER_LIST_INFO mengembalikan makro NDIS_TCP_IP_CHECKSUM_NET_BUFFER_LIST_INFO struktur. Struktur ini berisi serikat yang memungkinkan informasi checksum yang akan diakses sebagai nilai PVOID tunggal atau sebagai bidang bit.
`TcpOffloadBytesTransferred` Mengidentifikasi nilai ULONG yang merupakan jumlah byte data yang ditransfer dalam cerobong asap TCP operasi pengiriman, penerimaan, atau pemutusan sambungan offload.
`IPsecOffloadV1NetBufferListInfo` Mengidentifikasi informasi keamanan Protokol Internet (IPsec) yang digunakan dalam membongkar tugas IPsec dari protokol TCP/IP ke driver miniport. Kapan IPsecOffloadV1NetBufferListInfo ditentukan, NET_BUFFER_LIST_INFO mengembalikan NDIS_IPSEC_OFFLOAD_V1_NET_BUFFER_LIST_INFO struktur.
`IPsecOffloadV2NetBufferListInfo` Menentukan informasi offload keamanan protokol Internet versi 2 (IPsecV2) yang digunakan di membongkar tugas IPsec dari protokol TCP/IP ke driver miniport. Saat Anda menentukan IPsecOffloadV2NetBufferListInfo, NET_BUFFER_LIST_INFO mengembalikan NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO struktur.
`TcpLargeSendNetBufferListInfo` Mengidentifikasi informasi yang digunakan dalam membongkar segmentasi paket TCP besar dari Protokol TCP/IP ke adaptor miniport untuk offload pengiriman besar versi 1 (LSOV1) dan offload pengiriman besar versi 2 (LSOV2). Kapan TcpLargeSendNetBufferListInfo ditentukan, NET_BUFFER_LIST_INFO mengembalikan NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO struktur. Struktur ini berisi serikat yang memungkinkan informasi diakses sebagai nilai PVOID tunggal atau sebagai bidang bit. Sebelum meneruskan paket TCP besar ke driver miniport untuk segmentasi, protokol TCP/IP menulis nilai dalam LsoV1Transmit anggota dari struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO untuk LSOV1 atau Anggota LsoV2Transmit untuk LSOV2. Sebelum menyelesaikan pengiriman paket TCP besar yang dimilikinya disegmentasi menjadi paket yang lebih kecil, driver miniport menulis nilai dalam LsoV1TransmitComplete anggota dari struktur NDIS_TCP_LARGE_SEND_OFFLOAD_NET_BUFFER_LIST_INFO untuk LSOV1 atau Anggota LsoV2TransmitComplete untuk LSOV2. Untuk LSOV1, nilai yang ditulis driver miniport termasuk jumlah total byte payload TCP yang dikirim driver miniport dalam paket yang dikirimnya tersegmentasi dari paket TCP besar.
`TcpReceiveNoPush` Mengidentifikasi nilai Boolean yang mewakili mode pendorongan permintaan penerimaan offload cerobong asap TCP. Jika TRUE, permintaan terima berada dalam mode non-pendorongan. Jika tidak, permintaan terima dalam mode pendorongan.
`ClassificationHandleNetBufferListInfo` Dicadangkan.
`Ieee8021QNetBufferListInfo` Mengidentifikasi informasi 802.1Q tentang paket. Kapan Ieee8021QNetBufferListInfo ditentukan, NET_BUFFER_LIST_INFO mengembalikan Nilai anggota dari sebuah NDIS_NET_BUFFER_LIST_8021Q_INFO struktur. Struktur ini dapat menentukan prioritas 802.1p dan VLAN informasi pengidentifikasi. Informasi prioritas 802.1p digunakan untuk menetapkan prioritas paket di media bersama 802 jaringan. Driver miniport yang mendukung tag 802.1Q dalam perangkat keras harus menggunakan NDIS_NET_BUFFER_LIST_8021Q_INFO struktur untuk operasi transmisi dan penerimaan.
`NetBufferListCancelId` Mengidentifikasi nilai ULONG_PTR yang merupakan pengidentifikasi pembatalan untuk NET_BUFFER_LIST struktur. Untuk membatalkan transmisi tertunda dari struktur NET_BUFFER_LIST yang ditandai, driver protokol melewati paket pengidentifikasi pembatalan ke NdisCancelSendNetBufferLists. Driver harus memanggil NdisGeneratePartialCancelId untuk mendapatkan nilai yang harus digunakan driver sebagai byte urutan tinggi dari pengidentifikasi pembatalan.
`MediaSpecificInformation` Mengidentifikasi nilai PVOID yang merupakan alamat buffer yang dialokasikan driver. Buffer ini berisi setiap data out-of-band khusus media yang menyertai NET_BUFFER struktur yang terkait dengan struktur NET_BUFFER_LIST . Jika driver protokol mengalokasikan data out-of-band, driver tersebut mengonfigurasi data untuk operasi pengiriman. Jika driver miniport mengalokasikan data, driver tersebut mengonfigurasi data untuk penerimaan Indikasi.
`NetBufferListFrameType` Mengidentifikasi nilai USHORT yang merupakan jenis bingkai paket Ethernet yang diterima.
`NetBufferListProtocolId` Mengidentifikasi nilai UCHAR yang merupakan pengidentifikasi protokol sebagai salah satu nilai berikut: NDIS_PROTOCOL_ID_DEFAULT Pengidentifikasi driver protokol default. NDIS_PROTOCOL_ID_TCP_IP Protokol TCP/IP. NDIS_PROTOCOL_ID_IPX Protokol IPX. NDIS_PROTOCOL_ID_NBF Protokol NetBEUI.
`NetBufferListHashValue` Pada jalur penerimaan, NetBufferListHashValue mengidentifikasi nilai ULONG yang merupakan nilai hash RSS yang dihitung NIC, jika ada. Pada jalur transmisi, NetBufferListHashValue mengidentifikasi nilai ULONG yang merupakan nilai hash RSS yang dihitung TCP/IP, jika ada. Dalam hal ini, semua struktur NET_BUFFER dalam struktur NET_BUFFER_LIST yang dikirimkan TCP/IP milik koneksi UDP atau TCP yang sama. Oleh karena itu, nilai hash ini berlaku untuk semua NET_BUFFER struktur yang berada dalam struktur NET_BUFFER_LIST . Untuk mengetahui informasi selengkapnya, lihat Menunjukkan Penerimaan RSS Data.
`NetBufferListHashInfo` Mengidentifikasi nilai ULONG yang merupakan informasi hash RSS, yang mencakup fungsi hash dan jenis hash. Untuk mengetahui informasi selengkapnya, lihat Menunjukkan Penerimaan RSS Data.
`WfpNetBufferListInfo` Dicadangkan untuk digunakan oleh Platform Pemfilteran Windows (WFP). Tidak ada driver, termasuk callout WFP driver, dapat menyimpan informasi dengan menggunakan nilai ini.
`IPsecOffloadV2TunnelNetBufferListInfo` Menentukan informasi terowongan IPsecV2 yang digunakan dalam membongkar tugas IPsec dari protokol TCP/IP ke pengemudi miniport. Saat Anda menentukan IPsecOffloadV2TunnelNetBufferListInfo, NET_BUFFER_LIST_INFO mengembalikan NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO struktur.
`IPsecOffloadV2HeaderNetBufferListInfo` Menentukan informasi header IPsecV2 yang digunakan dalam membongkar tugas IPsec dari protokol TCP/IP ke pengemudi miniport. Saat Anda menentukan IPsecOffloadV2HeaderNetBufferListInfo, NET_BUFFER_LIST_INFO mengembalikan NDIS_IPSEC_OFFLOAD_V2_HEADER_NET_BUFFER_LIST_INFO struktur.
`NetBufferListCorrelationId` Dicadangkan.
`NetBufferListFilteringInfo` Menentukan informasi pemfilteran yang digunakan dalam antarmuka antrean komputer virtual (VMQ), antarmuka virtualisasi I/O root tunggal (SR-IOV), dan penggalian paket NDIS. Saat Anda menentukan NetBufferListFilteringInfo, NET_BUFFER_LIST_INFO mengembalikan NDIS_NET_BUFFER_LIST_FILTERING_INFO struktur. Dimulai dengan NDIS 6.20, menerima indikasi yang dibuat oleh driver miniport yang mendukung VMQ, SR-IOV, atau coalescing paket harus menyertakan struktur NDIS_NET_BUFFER_LIST_FILTERING_INFO . Driver miniport harus mengatur pengidentifikasi antrean VMQ di Anggota QueueId dari NDIS_NET_BUFFER_LIST_FILTERING_INFO struktur. Driver juga mengatur anggota FilterId dari struktur NDIS_NET_BUFFER_LIST_FILTERING_INFO ke nol. Catatan Dimulai dengan NDIS 6.30, driver miniport yang mendukung SR-IOV atau coalescing paket harus mengatur QueueId ke NDIS_DEFAULT_RECEIVE_QUEUE_ID dan anggota FilterId ke nol.
`MediaSpecificInformationEx` Mengidentifikasi penunjuk ke driver yang dialokasikan NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX struktur. Struktur ini mengidentifikasi media spesifik apa pun data di luar band yang menyertai struktur NET_BUFFER yang terkait dengan NET_BUFFER_LIST Struktur. Driver NDIS 6.20 dan yang lebih baru harus menggunakan struktur NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX untuk menentukan informasi spesifik media. Setiap driver dalam tumpukan driver NDIS dapat mengalokasikan dan mengelola informasi khusus media.
`NblOriginalInterfaceIfIndex` Dicadangkan.
`NblReAuthWfpFlowContext` Dicadangkan.
`TcpReceiveBytesTransferred` Mengidentifikasi nilai ULONG yang merupakan jumlah byte data yang diterima oleh tumpukan host dan mengisi permintaan terima yang sedang diproses sebagai operasi penerimaan offload cerobong asap TCP.
`NrtNameResolutionId` Dicadangkan.
`UdpRecvSegCoalesceOffloadInfo` Dicadangkan untuk penggunaan driver protokol.
`SwitchForwardingReserved` Dicadangkan untuk NDIS.
`SwitchForwardingDetail` Mengidentifikasi pointer ke struktur NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO yang dialokasikan driver. Struktur ini menentukan informasi untuk meneruskan paket ke satu atau beberapa port sakelar hyper-V yang dapat diperluas. Driver mengalokasikan struktur ini dengan memanggil AllocateNetBufferListForwardingContext dan membebaskan struktur dengan memanggil FreeNetBufferListForwardingContext.
`VirtualSubnetInfo` Mengidentifikasi penunjuk ke struktur NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO yang dialokasikan driver.
`IMReserved` Dicadangkan untuk NDIS.
`TcpRecvSegCoalesceInfo` Mengidentifikasi penunjuk ke serikat NDIS_RSC_NBL_INFO yang dialokasikan driver yang berisi informasi penghitung receive segment coalescing (RSC). Untuk informasi selengkapnya, lihat dokumentasi NDIS_RSC_NBL_INFO .
`UdpSegmentationOffloadInfo` Mengidentifikasi informasi yang digunakan dalam membongkar segmentasi paket TCP besar dari protokol TCP/IP ke adaptor miniport untuk UDP Segmentation Offload (USO). Ketika UdpSegmentationOffloadInfo ditentukan, NET_BUFFER_LIST_INFO mengembalikan struktur NDIS_UDP_SEGMENTATION_OFFLOAD_NET_BUFFER_LIST_INFO . Struktur ini berisi penyatuan yang memungkinkan informasi diakses sebagai nilai PVOID tunggal atau sebagai bidang bit.
`RscTcpTimestampDelta` Mengidentifikasi nilai ULONG yang berisi informasi tanda waktu RSC. Untuk informasi selengkapnya, lihat dokumentasi NDIS_RSC_NBL_INFO .
`TcpSendOffloadsSupplementalNetBufferListInfo` Mengidentifikasi pointer ke struktur NDIS_TCP_SEND_OFFLOADS_SUPPLEMENTAL_NET_BUFFER_LIST_INFO yang dialokasikan driver yang berisi informasi out-of-band tambahan untuk paket yang dienkapsulasi.
`GftOffloadInformation` Informasi Offload Tabel Alur Generik (GFT).
`GftFlowEntryId` ID entri alur untuk GFT.
`NetBufferListInfoReserved3` Dicadangkan.
`SwitchForwardingReserved` Dicadangkan untuk NDIS.
`SwitchForwardingDetail_b0_to_b31` Mengidentifikasi pointer ke struktur NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO yang dialokasikan driver. SwitchForwardingDetail_b0_to_b31 dan SwitchForwardingDetail_b32_to_b63 digunakan untuk memuat data OOB 64b untuk mode 32b. Tersedia dalam NDIS 6.82 dan yang lebih tinggi.
`SwitchForwardingDetail_b32_to_b63` Lihat SwitchForwardingDetail_b0_to_b31.
`VirtualSubnetInfo` Mengidentifikasi penunjuk ke struktur NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO yang dialokasikan driver.
`NetBufferListInfoReserved1` Dicadangkan untuk NDIS.
`NetBufferListInfoReserved2` Dicadangkan untuk NDIS.
`MaxNetBufferListInfo` Nilai maksimum untuk enumerasi ini. Nilai ini mungkin berubah dalam versi file header dan biner NDIS yang akan datang.

Keterangan

Enumerasi NDIS_NET_BUFFER_LIST_INFO digunakan dalam struktur NET_BUFFER_LIST .

Gunakan nilai enumerasi ini dengan makro NET_BUFFER_LIST_INFO untuk mengatur dan mendapatkan nilai dalam array NetBufferListInfo dalam NET_BUFFER_LIST.