Fungsi NdisOffloadTcpDisconnect (ndischimney.h)

Artikel
08/07/2023

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

Protokol atau driver perantara memanggil fungsi NdisOffloadTcpDisconnect untuk menutup setengah pengiriman koneksi TCP yang dilepas. Selain itu, jika pemutusan yang akan dilakukan adalah pemutusan sambungan yang lancar, protokol atau driver perantara dapat menyediakan data aplikasi yang harus ditransmisikan target offload yang mendasar pada koneksi TCP yang dilepas sebelum mengirim segmen FIN.

Sintaks

NDIS_STATUS NdisOffloadTcpDisconnect(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList,
  [in] IN ULONG                Flags
);

Parameter

[in] NdisOffloadHandle

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

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST tunggal. Hanya satu struktur NET_BUFFER yang terkait dengan struktur NET_BUFFER_LIST ini.

[in] Flags

Sebagai salah satu nilai berikut, jenis pemutusan sambungan yang akan dilakukan:

TCP_DISCONNECT_ABORTIVE_CLOSE

Menentukan bahwa target offload melakukan pemutusan sambungan abortif dengan mengirim segmen RST.

TCP_DISCONNECT_GRACEFUL_CLOSE

Menentukan bahwa target offload melakukan pemutusan sambungan dengan anggun dengan mengirim segmen FIN.

Mengembalikan nilai

Fungsi NdisOffloadTcpDisconnect selalu mengembalikan NDIS_STATUS_PENDING. Operasi pemutusan sambungan selalu diselesaikan secara asinkron.

Keterangan

Menanggapi panggilan ke Fungsi MiniportTcpOffloadDisconnect , driver perantara memanggil fungsi NdisOffloadTcpDisconnect untuk menyebarluaskan operasi pemutusan sambungan ke driver perantara atau target offload yang mendasar. Untuk informasi selengkapnya, lihat Menyebarkan Operasi I/O.

Untuk fungsi NdisOffloadTcpXxx , 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 fungsi MiniportTcpOffloadDisconnect driver perantara.
Bendera yang sama yang diteruskan NDIS ke fungsi MiniportTcpOffloadDisconnect driver perantara.

Ketika driver yang mendasar atau target offload kemudian menyelesaikan operasi pemutusan sambungan dengan memanggil fungsi NdisTcpOffloadDisconnectComplete , NDIS memanggil fungsi ProtocolOffloadDisconnectComplete driver menengah. Driver perantara kemudian memanggil fungsi NdisTcpOffloadDisconnectComplete untuk menyebarluaskan penyelesaian operasi pemutusan sambungan.