Fungsi NdisOffloadTcpForward (ndischimney.h)

Artikel
02/29/2024

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

Driver protokol atau driver perantara memanggil fungsi NdisOffloadTcpForward untuk meneruskan segmen TCP yang diterima yang tidak diakui ke target driver atau offload yang mendasar.

Sintaks

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Parameter

[in] NdisOffloadHandle

Handel ke struktur NDIS_OFFLOAD_HANDLE dalam konteks pemanggil untuk koneksi TCP yang dibongkar. Untuk mengetahui informasi selengkapnya, lihat Mereferensikan Status Offload melalui Driver Perantara.

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST . Struktur ini bisa menjadi struktur yang berdiri sendiri atau struktur pertama dalam daftar struktur NET_BUFFER_LIST yang ditautkan. Setiap struktur NET_BUFFER_LIST dalam daftar menjelaskan satu struktur NET_BUFFER . Setiap struktur NET_BUFFER menunjuk ke rantai daftar deskriptor memori (MDL). MDL yang terkait dengan struktur NET_BUFFER berisi satu dan hanya satu segmen TCP yang sedang diteruskan ke target offload. Byte pertama dari MDL pertama adalah byte pertama dari header TCP. Struktur NET_BUFFER_LIST dan terkait dikunci sehingga tetap tinggal dalam memori fisik. Namun, mereka tidak dipetakan ke dalam memori sistem.

Mengembalikan nilai

Fungsi NdisOffloadTcpForward selalu mengembalikan NDIS_STATUS_PENDING. Operasi penerusan selalu diselesaikan secara asinkron.

Keterangan

Menanggapi panggilan ke fungsi MiniportTcpOffloadForward , driver perantara memanggil fungsi NdisOffloadTcpForward untuk menyebarluaskan operasi penerusan ke driver atau target offload yang mendasar. Untuk informasi selengkapnya, lihat Menyebarkan Operasi I/O.

Untuk fungsi NdisOffloadTcpForward , driver perantara melewati yang berikut:

Fungsi NdisOffloadHandle yang mereferensikan struktur NDIS_OFFLOAD_HANDLE yang disimpan dalam konteks driver perantara untuk koneksi TCP yang dibongkar. Untuk mengetahui informasi selengkapnya, lihat Mereferensikan Status Offload melalui Driver Perantara.
Pointer PNET_BUFFER_LIST yang sama dengan yang diteruskan NDIS ke driver perantara Fungsi MiniportTcpOffloadForward .

Ketika driver yang mendasar atau target offload kemudian menyelesaikan operasi penerusan dengan memanggil fungsi NdisTcpOffloadForwardComplete , NDIS memanggil fungsi ProtocolOffloadForwardComplete driver perantara. Driver perantara kemudian memanggil fungsi NdisTcpOffloadForwardComplete untuk menyebarluaskan penyelesaian operasi penerusan.