W_QUERY_OFFLOAD_HANDLER fungsi panggilan balik (ndischimney.h)

Artikel
08/07/2023

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

Fungsi MiniportQueryOffload mengkueri objek status cerobong asap TCP yang sebelumnya dibongkar.

Sintaks

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] MiniportAdapterContext

Handel ke area konteks yang dialokasikan target offload tempat target offload mempertahankan informasi status tentang instans adaptor ini. Target offload memberikan handel ini ke NDIS ketika dipanggil NdisMSetMiniportAttributes dari Fungsi MiniportInitializeEx .

[in, out] OffloadBlockList

Penunjuk ke NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struktur, yang dapat menjadi akar dari daftar tertaut struktur tersebut. Struktur ini mengidentifikasi status offload yang sedang dikueri.

Nilai kembali

Tidak ada

Keterangan

Fungsi MiniportQueryOffload dapat meminta status cerobong asap TCP apa pun yang telah dilepas ke target offload.

Fungsi MiniportQueryOffload menyimpan penunjuk OffloadBlockList lalu mengembalikan. Target offload selalu menyelesaikan operasi kueri secara asinkron dengan memanggil Fungsi NdisMQueryOffloadStateComplete . Penunjuk OffloadBlockList menunjuk ke NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struktur yang dapat berupa struktur yang berdiri sendiri atau simpul akar dalam pohon status offload. Pohon status valid sampai target offload memanggil fungsi NdisMQueryOffloadStateComplete .

Setelah kembali dari fungsi MiniportQueryOffload , driver miniport mengisi struktur status offload yang terkait dengan setiap struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di pohon status yang ditujukan oleh penunjuk OffloadBlockList . Untuk masing-masing struktur status offload ini, driver miniport menulis nilai saat ini dari setiap variabel dalam struktur.

Sebelum memanggil fungsi NdisMQueryOffloadStateComplete , target offload harus menulis salah satu nilai NDIS_STATUS berikut ke anggota Status dari setiap struktur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST di pohon status:

NDIS_STATUS_SUCCESS
Target offload berhasil mengkueri objek status.
NDIS_STATUS_FAILURE
Operasi kueri tidak berhasil. Tumpukan host akan mengakhiri objek status yang tidak dapat dikueri.