Fungsi NdisOffloadTcpSend (ndischimney.h)

Artikel
02/29/2024

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

Driver protokol atau driver perantara memanggil fungsi NdisOffloadTcpSend untuk mengirimkan data pada koneksi TCP yang dibongkar.

Sintaks

NDIS_STATUS NdisOffloadTcpSend(
  [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 Terbongkar 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 daftar struktur NET_BUFFER . Setiap struktur NET_BUFFER dalam daftar menunjuk ke rantai daftar deskriptor memori (MDL). MDL berisi data yang akan dikirimkan. Struktur NET_BUFFER_LIST dan terkait terkunci sehingga mereka tetap tinggal dalam memori fisik. Namun, mereka tidak dipetakan ke dalam memori sistem.

Mengembalikan nilai

Fungsi NdisOffloadTcpSend selalu mengembalikan NDIS_STATUS_PENDING. Operasi pengiriman selalu diselesaikan secara asinkron.

Keterangan

Menanggapi panggilan ke fungsi MiniportTcpOffloadSend , driver perantara memanggil fungsi NdisOffloadTcpSend untuk menyebarluaskan operasi pengiriman ke driver menengah atau target offload yang mendasar. Untuk informasi selengkapnya, lihat Menyebarkan Operasi I/O.

Untuk fungsi NdisOffloadTcpSend , driver perantara melewati yang berikut:

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 Terbongkar Melalui Driver Perantara.
Pointer PNET_BUFFER_LIST yang sama dengan yang diteruskan NDIS ke fungsi MiniportTcpOffloadSend driver perantara.

Ketika target driver atau offload yang mendasar kemudian menyelesaikan operasi pengiriman dengan memanggil fungsi NdisTcpOffloadSendComplete , NDIS memanggil fungsi ProtocolOffloadSendComplete driver perantara. Driver perantara kemudian memanggil fungsi NdisTcpOffloadSendComplete untuk menyebarluaskan penyelesaian operasi pengiriman.