Bagikan melalui

Persyaratan INF untuk Ekstensi Sakelar Yang Dapat Diperluas Hyper-V

  • Artikel

Ekstensi sakelar yang dapat diperluas Hyper-V dikembangkan sebagai driver filter NDIS. Akibatnya, persyaratan INF untuk ekstensi didasarkan pada persyaratan INF untuk semua driver filter NDIS. Saat Anda membuat file INF untuk ekstensi sakelar yang dapat diperluas, Anda harus menggunakan pengaturan INF untuk memodifikasi atau memantau driver filter. Untuk informasi selengkapnya tentang pengaturan ini, lihat Pengaturan File INF untuk Driver Filter.

Selain itu, Anda harus mengikuti panduan ini untuk file INF untuk ekstensi sakelar yang dapat diperluas:

  • Ekstensi sakelar yang dapat diperluas harus diinstal sebagai pengandar filter yang memodifikasi.

    Untuk informasi selengkapnya tentang persyaratan INF untuk memodifikasi driver filter, lihat Mengonfigurasi File INF untuk Memodifikasi Driver Filter.

    Catatan Ekstensi dengan kelas filter ms_switch_capture dapat melakukan tugas yang sama dengan driver filter pemantauan. Untuk informasi selengkapnya, lihat Jenis Driver Filter.

  • Entri FilterMediaTypes dalam file INF filter menentukan pengikatan driver ke driver dan antarmuka lain. Entri FilterMediaTypes untuk ekstensi sakelar yang dapat diperluas harus menyertakan nilai vmnetextension . Nilai ini menentukan pengikatan ke adaptor miniport ekstensi sakelar yang dapat diperluas.

    Entri FilterMediaTypes memungkinkan daftar tipe media yang dibatasi koma ditentukan. Ini memungkinkan ekstensi terikat ke antarmuka fisik atau ke antarmuka sakelar yang dapat diperluas.

    Contoh berikut menunjukkan entri FilterMediaTypes yang memungkinkan ekstensi terikat ke adaptor jaringan Ethernet fisik atau adaptor jaringan virtual sakelar yang dapat diperluas.

    HKR, Ndi\Interfaces, FilterMediaTypes, , "ethernet, vmnetextension"

    Jika entri FilterMediaTypes hanya menentukan nilai vmnetextension , ekstensi hanya akan mengikat ke tumpukan driver untuk semua sakelar yang dapat diperluas pada sistem.

    Jika entri FilterMediaTypes menentukan vmnetextension serta jenis media lainnya, ekstensi dapat menentukan apakah itu terikat dalam tumpukan driver sakelar yang dapat diperluas dengan memanggil NdisFGetOptionalSwitchHandlers. Jika fungsi mengembalikan NDIS_STATUS_SUCCESS, ekstensi terikat dalam tumpukan driver ekstensi. Jika fungsi mengembalikan NDIS_STATUS_NOT_SUPPORTED, ekstensi terikat dalam tumpukan driver untuk antarmuka jaringan fisik yang berbeda.

    Untuk informasi selengkapnya tentang entri FilterMediaTypes , lihat Entri File INF UpperRange Dan LowerRange Driver Menengah.

  • Nilai FilterClass dalam file INF untuk ekstensi menentukan urutannya dalam tumpukan filter. Entri FilterClass harus berisi salah satu nilai dari tabel berikut.

    Nilai FilterClass Deskripsi

    ms_switch_capture

    Ekstensi kelas ini memantau lalu lintas paket. Namun, kelas ekstensi ini tidak dapat menerapkan kebijakan port atau mengubah port tujuan untuk paket.

    Untuk informasi selengkapnya tentang kelas ekstensi ini, lihat Menangkap Ekstensi.

    ms_switch_filter

    Ekstensi kelas ini memfilter lalu lintas paket dan memberlakukan kebijakan port atau pengalihan untuk pengiriman paket melalui sakelar yang dapat diperluas. Kelas driver ini juga dapat memeriksa dan menghapus port tujuan untuk setiap paket berdasarkan pengaturan kebijakan.

    Untuk informasi selengkapnya tentang kelas ekstensi ini, lihat Ekstensi Pemfilteran.

    ms_switch_forward

    Ekstensi kelas ini memiliki kemampuan yang sama dengan kelas ms_switch_filter . Kelas ekstensi ini juga dapat meneruskan paket ke port switch yang dapat diperluas lainnya, serta menyuntikkan lalu lintas paket ke port switch yang dapat diperluas.

    Pada jalur data ingress, kelas ekstensi ini dipanggil setelah kelas ekstensi ms_switch_filter . Pada jalur data keluar, kelas ekstensi ini dipanggil sebelum kelas ekstensi ms_switch_filter .

    Untuk informasi selengkapnya tentang kelas ekstensi ini, lihat Ekstensi Penerusan.

    Catatan Hanya satu ekstensi kelas ini yang diperbolehkan dalam tumpukan driver sakelar yang dapat diperluas.

Ketika ekstensi diinstal dengan pengaturan INF ini, ekstensi akan dikonfigurasi untuk mengikat setiap instans sakelar yang dapat diperluas. Namun, pengikatan akan dinonaktifkan dan harus diaktifkan secara eksplisit melalui cmdlet PowerShell. Untuk informasi selengkapnya tentang prosedur ini, lihat Mengaktifkan Ekstensi Sakelar Yang Dapat Diperluas Hyper-V.