NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS fungsi panggilan balik (ndis.h)

Artikel
02/29/2024

Fungsi GrowNetBufferListDestinations menambahkan ruang untuk port tujuan sakelar hyper-V tambahan yang dapat diperluas ke paket yang ditentukan oleh struktur NET_BUFFER_LIST .

Sintaks

NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS NdisSwitchGrowNetBufferListDestinations;

NDIS_STATUS NdisSwitchGrowNetBufferListDestinations(
  [in]  NDIS_SWITCH_CONTEXT NdisSwitchContext,
        PNET_BUFFER_LIST NetBufferList,
  [in]  UINT32 NumberOfNewDestinations,
  [out] PNDIS_SWITCH_FORWARDING_DESTINATION_ARRAY *Destinations
)
{...}

Parameter

[in] NdisSwitchContext

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

NetBufferList

Penunjuk ke daftar struktur NET_BUFFER_LIST yang ditautkan.

Catatan Struktur ini harus berisi konteks penerusan sakelar yang dapat diperluas. Jika ekstensi membuat atau mengkloning paket, sebelumnya harus mengalokasikan struktur ini dengan memanggil fungsi AllocateNetBufferListForwardingContext . Untuk informasi selengkapnya tentang konteks penerusan sakelar yang dapat diperluas, lihat Konteks Penerusan Sakelar Yang Dapat Diperluas Hyper-V.

[in] NumberOfNewDestinations

Nilai UINT32 yang menentukan jumlah port tujuan baru yang akan ditambahkan untuk paket.

[out] Destinations

Penunjuk ke struktur NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY . Struktur ini menentukan port tujuan sakelar yang dapat diperluas dari paket.

Nilai kembali

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

Keterangan

Ekstensi sakelar yang dapat diperluas memanggil fungsi GrowNetBufferListDestinations untuk menambahkan ruang untuk port tujuan untuk paket. Tujuan port ditentukan melalui struktur NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY .

Untuk informasi selengkapnya tentang cara menambahkan port tujuan ke paket, lihat Menambahkan Data Port Tujuan Switch yang Dapat Diperluas ke Paket.

Catatan Jika parameter NetBufferList berisi penunjuk ke daftar tertaut dari beberapa struktur NET_BUFFER_LIST , ruang untuk port tujuan tambahan hanya ditambahkan ke struktur NET_BUFFER_LIST pertama dalam daftar.

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