Fungsi NdisOffloadTcpReceive (ndischimney.h)

Artikel
02/26/2024

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

Driver protokol atau driver perantara memanggil fungsi NdisOffloadTcpReceive untuk memposting permintaan terima (menerima buffer) pada koneksi TCP yang dilepas.

Sintaks

NDIS_STATUS NdisOffloadTcpReceive(
  [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 . Struktur NET_BUFFER menunjuk ke rantai daftar deskriptor memori (MDL). Struktur NET_BUFFER_LIST dan terkait dikunci sehingga tetap tinggal dalam memori fisik. Namun, mereka tidak dipetakan ke dalam memori sistem.

Mengembalikan nilai

Fungsi NdisOffloadTcpReceive selalu mengembalikan NDIS_STATUS_PENDING. Operasi penerimaan selalu diselesaikan secara asinkron.

Keterangan

Menanggapi panggilan ke Fungsi MiniportTcpOffloadReceive , driver perantara memanggil fungsi NdisOffloadTcpReceive untuk menyebarluaskan operasi terima ke driver perantara atau target offload yang mendasar. Untuk informasi selengkapnya, lihat Menyebarkan Operasi I/O.

Untuk fungsi NdisOffloadTcpReceive , 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 MiniportTcpOffloadReceive driver perantara.

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