Fungsi NdisFGetOptionalSwitchHandlers (ndis.h)

Ekstensi sakelar yang dapat diperluas Hyper-V memanggil fungsi NdisFGetOptionalSwitchHandlers untuk mendapatkan daftar pointer ke fungsi handler sakelar yang dapat diperluas Hyper-V.

Sintaks

NDIS_STATUS NdisFGetOptionalSwitchHandlers(
  [in]      NDIS_HANDLE                    NdisFilterHandle,
  [out]     PNDIS_SWITCH_CONTEXT           NdisSwitchContext,
  [in, out] PNDIS_SWITCH_OPTIONAL_HANDLERS NdisSwitchHandlers
);

Parameter

[in] NdisFilterHandle

Handel NDIS yang mengidentifikasi modul filter ini. Ketika NDIS memanggil fungsi FilterAttach ekstensi, NDIS meneruskan handel ini di parameter NdisFilterHandle .

[out] NdisSwitchContext

Penunjuk ke nilai NDIS_SWITCH_CONTEXT yang mengidentifikasi modul sakelar yang dapat diperluas tempat ekstensi dilampirkan. Ketika ekstensi memanggil fungsi handler sakelar yang dapat diperluas, ekstensi harus mengatur parameter NdisSwitchContext ke nilai handel ini.

[in, out] NdisSwitchHandlers

Penunjuk ke struktur NDIS_SWITCH_OPTIONAL_HANDLERS yang dialokasikan penelepon. Jika panggilan berhasil, struktur ini akan berisi daftar penunjuk ke fungsi handler switch yang dapat diperluas.

Untuk informasi selengkapnya tentang fungsi handler ini, lihat Hyper-V Extensible Switch Handler Functions.

Catatan Sebelum ekstensi memanggil NdisFGetOptionalSwitchHandlers, ekstensi harus menginisialisasi anggota Header dari struktur NDIS_SWITCH_OPTIONAL_HANDLERS .

 

Nilai kembali

Jika panggilan berhasil, NdisFGetOptionalSwitchHandlers mengembalikan NDIS_STATUS_SUCCESS. Jika tidak, ia mengembalikan NDIS_STATUS_NOT_SUPPORTED jika ekstensi sakelar yang dapat diperluas tidak terikat ke komponen sakelar yang dapat diperluas yang mendasar.

Keterangan

Ekstensi ini memanggil fungsi NdisFGetOptionalSwitchHandlers dari fungsi FilterAttach-nya .

Jika ekstensi diinstal dengan beberapa entri INF FilterMediaTypes , panggilan ke NdisFGetOptionalSwitchHandlers memungkinkan ekstensi menentukan apakah itu terikat dan terpasang ke tumpukan driver untuk sakelar yang dapat diperluas atau adaptor jaringan fisik. Jika panggilan mengembalikan NDIS_STATUS_SUCCESS, ekstensi dilampirkan dalam tumpukan driver sakelar yang dapat diperluas. Jika panggilan mengembalikan NDIS_STATUS_NOT_SUPPORTED, ekstensi dilampirkan dalam tumpukan driver untuk adaptor jaringan fisik.

Untuk informasi selengkapnya tentang entri INF FilterMediaTypes untuk ekstensi sakelar yang dapat diperluas, lihat Persyaratan INF untuk Ekstensi Sakelar yang Dapat Diperluas Hyper-V.

Persyaratan

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

Lihat juga

FilterAttach

NDIS_SWITCH_OPTIONAL_HANDLERS