NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT fungsi panggilan balik (ndis.h)

  • Artikel

Fungsi FreeNetBufferListForwardingContext merilis sumber daya dalam konteks penerusan sakelar out-of-band (OOB) yang dapat diperluas dari struktur NET_BUFFER_LIST . Data ini digunakan untuk operasi kirim atau terima dalam sakelar yang dapat diperluas Hyper-V, dan sebelumnya dialokasikan dengan memanggil fungsi AllocateNetBufferListForwardingContext .

Sintaks

NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT NdisSwitchFreeNetBufferListForwardingContext;

void NdisSwitchFreeNetBufferListForwardingContext(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] NdisSwitchContext

Nilai NDIS_SWITCH_CONTEXT yang berisi handel modul sakelar yang dapat diperluas tempat ekstensi sakelar yang dapat diperluas Hyper-V terpasang. Ketika ekstensi memanggil NdisFGetOptionalSwitchHandlers, handel ini dikembalikan melalui parameter NdisSwitchContext .

[in, out] NetBufferList

Penunjuk ke daftar struktur NET_BUFFER_LIST yang ditautkan.

Catatan Struktur ini harus berisi konteks penerusan sakelar yang dapat diperluas yang sebelumnya dialokasikan dengan memanggil fungsi AllocateNetBufferListForwardingContext .
 

Nilai kembali

Jika panggilan berhasil, fungsi akan mengembalikan NDIS_STATUS_SUCCESS. Jika tidak, kode kesalahan NDIS_STATUS_Xxx akan dikembalikan yang ditentukan dalam Ndis.h.

Keterangan

Ekstensi sakelar yang dapat diperluas dapat memulai operasi pengiriman paket dalam jalur data sakelar yang dapat diperluas. Misalnya, ekstensi dapat mengirim paket ke port apa pun pada sakelar yang dapat diperluas. Untuk informasi selengkapnya tentang jalur data ini, lihat Jalur Data Hyper-V Extensible Switch.

Jika ekstensi sakelar yang dapat diperluas berasal dari operasi pengiriman paket, ekstensi harus memanggil fungsi AllocateNetBufferListForwardingContext . Fungsi ini mengalokasikan dan menginisialisasi konteks penerusan untuk struktur NET_BUFFER_LIST yang ditentukan. Untuk informasi selengkapnya tentang konteks ini, lihat Konteks Penerusan Sakelar yang Dapat Diperluas Hyper-V.

Ketika operasi pengiriman selesai, ekstensi harus memanggil fungsi FreeNetBufferListForwardingContext untuk membatalkan alokasi konteks penerusan.

Catatan Ekstensi harus memanggil fungsi FreeNetBufferListForwardingContext saat operasi pengiriman selesai. Ekstensi harus melakukan ini terlepas dari apakah itu menambahkan struktur NET_BUFFER_LIST paket ke daftar lookaside atau memanggil NdisFreeNetBufferList untuk mengembalikan struktur ke kumpulan.
 
Untuk informasi selengkapnya tentang cara memulai operasi pengiriman, lihat Memfilter Operasi Kirim dan Terima Modul.
Catatan Jika parameter NetBufferList berisi penunjuk ke daftar tertaut dari beberapa struktur NET_BUFFER_LIST , hanya struktur NET_BUFFER_LIST pertama dalam daftar yang tidak dialokasikan konteks penerusannya.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.30 dan yang lebih baru.
Target Platform Desktop
Header ndis.h (termasuk Ndis.h)
IRQL <= DISPATCH_LEVEL

Lihat juga

AllocateNetBufferListForwardingContext

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

NdisFreeNetBufferList