TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
08/07/2023

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

NDIS memanggil fungsi ProtocolTcpOffloadDisconnectComplete driver protokol atau driver perantara untuk menyelesaikan operasi pemutusan sambungan yang sebelumnya dimulai driver dengan memanggil Fungsi NdisOffloadTcpDisconnect .

Sintaks

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] ProtocolBindingContext

Handel ke area konteks yang dialokasikan oleh driver protokol. Driver mempertahankan informasi konteks per pengikatan di area konteks ini. Driver menyediakan handel ini ke NDIS ketika driver memanggil fungsi NdisOpenAdapterEx .

[in] NetBufferList

Saat non-NULL, penunjuk ke satu struktur NET_BUFFER_LIST . Driver menyediakan pointer ini sebagai parameter input dalam panggilan sebelumnya ke Fungsi NdisOffloadTcpDisconnect .

Nilai kembali

Tidak ada

Keterangan

Menanggapi panggilan target driver atau offload yang mendasar ke Fungsi NdisTcpOffloadDisconnectComplete , NDIS memanggil fungsi ProtocolTcpOffloadDisconnectComplete driver protokol yang terlalu berlebihan atau driver menengah ProtocolTcpOffloadDisconnectComplete .

Untuk menyebarluaskan penyelesaian operasi pemutusan sambungan ke driver yang terlalu berlebihan, driver perantara memanggil fungsi NdisOffloadTcpDisconnectComplete , meneruskan hal berikut:

ProtocolBindingContext, yang merupakan handel yang secara unik mengidentifikasi driver perantara.
Penunjuk PNET_BUFFER_LIST yang sama dengan yang diteruskan NDIS ke fungsi ProtocolTcpOffloadDisconnectComplete driver perantara.

Sebagai respons, NDIS memanggil fungsi ProtocolTcpOffloadDisconnectComplete driver yang terlalu berlebihan, meneruskan handel ProtocolBindingContext dan penunjuk PNET_BUFFER_LIST yang diteruskan oleh driver perantara ke fungsi NdisOffloadTcpDisconnectComplete .

Sebelum kembali, fungsi ProtocolTcpOffloadDisconnectComplete harus membatalkan alokasi memori untuk konteks apa pun yang dibuat untuk struktur NET_BUFFER_LIST yang diteruskan ke fungsi.

Perhatikan bahwa, jika driver perantara mengekspor lebih dari satu antarmuka ke protokol yang terlalu berlebihan, ia harus menentukan protokol mana yang harus menerima penyelesaian pemutusan sambungan. Untuk membuat penentuan ini, driver perantara menggunakan informasi yang disimpan dalam NET_BUFFER_LIST_CONTEXT struktur, yang terkait dengan struktur NET_BUFFER_LIST.