struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST (ndischimney.h)

Artikel
08/07/2023

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

Struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST adalah blok penyusun dasar pohon status offload cerobong asap TCP. Pohon status offload dapat berisi satu atau beberapa struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Sintaks

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  IN PVOID                             ProtocolReserved[2];
  IN PVOID                             MiniportReserved[2];
  IN PVOID                             ImReserved[2];
  IN PVOID                             Scratch[2];
  IN PVOID                             SourceHandle;
  IN NDIS_PORT_NUMBER                  PortNumber;
  IN OUT PNET_BUFFER_LIST              NetBufferListChain;
} NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

Anggota

Header

Header struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Header diformat sebagai struktur NDIS_OBJECT_HEADER . Struktur NDIS_OBJECT_HEADER berisi nomor revisi struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, jenis status offload yang segera mengikuti struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dalam memori, dan ukuran struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, termasuk header, dalam byte.

Jenis anggota struktur NDIS_OBJECT_HEADER menunjukkan jenis status offload, dan dengan implikasi, struktur status offload tertentu (atau struktur) yang segera mengikuti struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dalam memori.

Nilai OFFLOAD_STATE_TYPE berikut ini didukung:

NeighborOffloadConstState

Menentukan status tetangga yang konstan. Status ini diformat sebagai NEIGHBOR_OFFLOAD_STATE_CONST struktur.

NeighborOffloadCachedState

Menentukan status tetangga yang di-cache. Status ini diformat sebagai NEIGHBOR_OFFLOAD_STATE_CACHED struktur.

NeighborOffloadDelegatedState

Menentukan status tetangga yang didelegasikan. Status ini diformat sebagai NEIGHBOR_OFFLOAD_STATE_DELEGATED struktur.

NeighborOffloadState

Menentukan semua informasi status tetangga, termasuk status tetangga yang konstanta, di-cache, dan didelegasikan. Status ini diformat sebagai struktur NEIGHBOR_OFFLOAD_STATE_CONST, diikuti dengan struktur NEIGHBOR_OFFLOAD_STATE_CACHED, diikuti oleh struktur NEIGHBOR_OFFLOAD_STATE_DELEGATED.

Ip4OffloadConstState

Menentukan status jalur konstanta (IPv4). Status ini diformat sebagai PATH_OFFLOAD_STATE_CONST struktur.

Ip4OffloadCachedState

Menentukan status jalur yang di-cache (IPv4). Status ini diformat sebagai PATH_OFFLOAD_STATE_CACHED struktur.

Ip4OffloadDelegatedState

Menentukan status jalur yang didelegasikan (IPv4). Status ini diformat sebagai PATH_OFFLOAD_STATE_DELEGATED struktur. Saat ini tidak ada status jalur yang didelegasikan. Struktur PATH_OFFLOAD_STATE_DELEGATED tidak berisi variabel apa pun.

Ip4OffloadState

Menentukan semua status jalur (IPv4), termasuk status jalur konstanta, di-cache, dan didelegasikan. Status ini diformat sebagai struktur PATH_OFFLOAD_STATE_CONST, diikuti dengan struktur PATH_OFFLOAD_STATE_CACHED, diikuti dengan struktur PATH_OFFLOAD_STATE_DELEGATED.

Ip6OffloadConstState

Menentukan status jalur konstanta (IPv6). Status ini diformat sebagai struktur PATH_OFFLOAD_STATE_CONST.

Ip6OffloadCachedState

Menentukan status jalur yang di-cache (IPv6). Status ini diformat sebagai struktur PATH_OFFLOAD_STATE_CACHED.

Ip6OffloadDelegatedState

Menentukan status jalur yang didelegasikan (IPv6). Status ini diformat sebagai struktur PATH_OFFLOAD_STATE_DELEGATED. Saat ini, tidak ada status jalur yang didelegasikan. Struktur PATH_OFFLOAD_STATE_DELEGATED tidak berisi variabel apa pun.

Ip6OffloadState

Menentukan semua informasi status jalur (IPv6), termasuk status jalur konstanta, di-cache, dan didelegasikan. Status ini diformat sebagai struktur PATH_OFFLOAD_STATE_CONST, diikuti dengan struktur PATH_OFFLOAD_STATE_CACHED, diikuti dengan struktur PATH_OFFLOAD_STATE_DELEGATED.

TcpOffloadConstState

Menentukan status TCP konstanta. Status ini diformat sebagai TCP_OFFLOAD_STATE_CONST struktur.

TcpOffloadCachedState

Menentukan status TCP yang di-cache. Status ini diformat sebagai TCP_OFFLOAD_STATE_CACHED struktur.

TcpOffloadDelegatedState

Menentukan status TCP yang didelegasikan. Status ini diformat sebagai TCP_OFFLOAD_STATE_DELEGATED struktur.

TcpOffloadResourceState

Dicadangkan. Nilai OFFLOAD_STATE_TYPE ini, serta struktur TCP_OFFLOAD_RESOURCE_STATE, saat ini tidak digunakan.

TcpOffloadState

Menentukan semua informasi status TCP, termasuk status TCP konstanta, di-cache, dan didelegasikan. Status ini diformat sebagai struktur TCP_OFFLOAD_STATE_CONST, diikuti dengan struktur TCP_OFFLOAD_STATE_CACHED, diikuti dengan struktur TCP_OFFLOAD_STATE_DELEGATED.

FilterReservedOffloadState

Dicadangkan untuk driver filter.

NextBlock

Penunjuk ke struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST berikutnya pada lapisan status offload (tetangga, jalur, atau TCP) yang ditunjukkan oleh anggota Jenis anggota Header . NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struktur yang ditautkan melalui pointer NextBlock selalu berada pada lapisan yang sama dari status offload. Nilai NextBlockNULL menunjukkan bahwa tidak ada struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST berikutnya tambahan pada tingkat ini.

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

Penunjuk ke struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang berada pada lapisan dependen status offload (lapisan yang lebih tinggi di pohon status offload). Untuk offload cerobong asap TCP:

Anggota DependentBlockList dari struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di lapisan tetangga hanya dapat menunjuk ke struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di lapisan jalur.
Anggota DependentBlockList dari struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di lapisan jalur hanya dapat menunjuk ke struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di lapisan TCP.
Anggota DependentBlockList dari struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di lapisan TCP selalu NULL.

Nilai DependentBlockListNULL menunjukkan bahwa tidak ada struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dependen.

Status

Status penyelesaian offload yang dimulai, offload kueri, perbarui offload, batalkan offload, atau hentikan operasi offload yang dilakukan target offload pada status yang terkait dengan, atau direferensikan oleh, struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Bergantung pada operasi, target offload menulis salah satu nilai NDIS_STATUS berikut ke anggota Status :

NDIS_STATUS_SUCCESS

Memulai offload: Target offload berhasil membongkar status yang terkait dengan struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dan status yang terkait dengan semua struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang segera bergantung.

Kueri, perbarui, batalkan, atau hentikan offload: Target offload berhasil melakukan operasi pada status yang terkait dengan, atau direferensikan oleh, struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

Memulai offload: Target offload berhasil membongkar status yang terkait dengan struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, tetapi gagal membongkar status yang terkait dengan satu atau beberapa struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST yang segera bergantung.