Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Permintaan metode pengidentifikasi objek (OID) OID_SWITCH_NIC_REQUEST digunakan untuk merangkum dan meneruskan permintaan OID ke adaptor jaringan eksternal sakelar yang dapat diperluas Hyper-V. Ini memungkinkan permintaan OID yang dienkapsulasi dikirimkan ke driver untuk adaptor jaringan fisik yang mendasarinya yang terikat ke adaptor jaringan eksternal.
Permintaan OID ini juga digunakan untuk merangkum permintaan OID yang dikeluarkan ke adaptor jaringan lain yang terhubung ke port sakelar yang dapat diperluas. Dalam hal ini, permintaan OID yang dienkapsulasi diteruskan melalui tumpukan driver sakelar yang dapat diperluas untuk diperiksa oleh ekstensi.
InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_NIC_OID_REQUEST. Struktur ini menentukan informasi penerusan untuk permintaan OID. Struktur ini juga berisi penunjuk ke struktur NDIS_OID_REQUEST asli permintaan OID yang sedang diteruskan.
Komentar
Ketika permintaan OID tiba di antarmuka sakelar yang dapat diperluas Hyper-V, permintaan OID merangkumnya untuk meneruskannya ke jalur kontrol sakelar yang dapat diperluas. Permintaan OID ini mencakup hal-hal berikut:
Permintaan OID offload perangkat keras, termasuk permintaan untuk keamanan Protokol Internet (IPsec), antrean komputer virtual (VMQ), dan virtualisasi I/O root tunggal (SR-IOV). Permintaan OID ini dikeluarkan oleh protokol yang terlalu besar atau driver filter yang berjalan dalam sistem operasi manajemen partisi induk Hyper-V.
Ketika permintaan OID ini tiba di antarmuka sakelar yang dapat diperluas, tepi protokol sakelar yang dapat diperluas merangkum permintaan OID dalam struktur NDIS_SWITCH_NIC_OID_REQUEST. Tepi protokol mengatur anggota struktur ini dengan cara berikut:
DestinationPortId dan DestinationNicIndex diatur ke nilai yang sesuai untuk adaptor jaringan eksternal.
Jika permintaan OID berasal dari partisi turunan Hyper-V, SourcePortId dan sourceNicIndex diatur ke nilai yang sesuai untuk port dan adaptor jaringan yang digunakan oleh partisi. Jika tidak, SourcePortId dan SourceNicIndex diatur ke nol.
Catatan Ekstensi harus mempertahankan nilai anggota ini jika meneruskan atau mengalihkan permintaan OID.
Anggota OidRequest diatur ke penunjuk ke struktur NDIS_OID_REQUEST untuk permintaan OID yang dienkapsulasi.
Tepi protokol kemudian mengeluarkan permintaan OID_SWITCH_NIC_REQUEST untuk meneruskan permintaan OID yang dienkapsulasi ke jalur kontrol sakelar yang dapat diperluas ke adaptor jaringan eksternal.
Ekstensi penerusan yang mendasarinya dapat mengalihkan permintaan OID offload perangkat keras yang dienkapsulasi ke adaptor jaringan fisik yang terikat ke adaptor jaringan eksternal. Misalnya, jika ekstensi mendukung adaptor jaringan fisik dari tim sakelar yang dapat diperluas yang terikat ke adaptor jaringan eksternal, ekstensi dapat meneruskan permintaan OID_SWITCH_NIC_REQUEST ke adaptor fisik di tim failover penyeimbangan beban (LBFO) yang mendukung offload perangkat keras. Untuk informasi selengkapnya tentang prosedur ini, lihat Mengelola Permintaan OID Offload Perangkat Keras ke Adaptor Jaringan Fisik.
Untuk informasi selengkapnya tentang tim sakelar yang dapat diperluas, lihat Jenis Konfigurasi Adaptor Jaringan Fisik.
Permintaan OID multicast, termasuk OID_802_3_ADD_MULTICAST_ADDRESS dan OID_802_3_DELETE_MULTICAST_ADDRESS. Permintaan OID ini dikeluarkan oleh protokol yang terlalu besar dan driver filter yang berjalan di sistem operasi manajemen atau sistem operasi tamu partisi anak Hyper-V.
Ketika permintaan OID ini tiba di antarmuka sakelar yang dapat diperluas, tepi protokol sakelar yang dapat diperluas merangkum permintaan OID dalam struktur NDIS_SWITCH_NIC_OID_REQUEST. Tepi protokol juga mengatur SourcePortId dan sourceNicIndex anggota ke nilai yang sesuai untuk port dan adaptor jaringan tempat permintaan OID berasal. Tepi protokol kemudian mengeluarkan permintaan OID_SWITCH_NIC_REQUEST untuk meneruskan permintaan OID yang dienkapsulasi ke jalur kontrol sakelar yang dapat diperluas untuk diperiksa dengan ekstensi yang mendasarinya.
Catatan Dalam hal ini, tepi protokol mengatur DestinationPortId dan anggota DestinationNicIndex menjadi nol. Ini menentukan bahwa permintaan OID yang dienkapsulasi akan dikirimkan ke ekstensi di jalur kontrol.
Ekstensi penerusan yang mendasarinya dapat memeriksa permintaan OID yang dienkapsulasi ini dan mempertahankan informasi alamat multicast yang mereka tentukan. Misalnya, ekstensi mungkin memerlukan informasi ini jika berasal dari paket multicast yang diteruskannya ke port sakelar yang dapat diperluas.
Untuk informasi selengkapnya, lihat Permintaan OID Penerusan dari Partisi Anak Hyper-V.
Ekstensi penerusan juga dapat mengeluarkan OID_SWITCH_NIC_REQUEST untuk meneruskan permintaan OID yang dienkapsulasi ke adaptor jaringan fisik yang terikat ke adaptor jaringan eksternal. Ini memungkinkan ekstensi untuk memulai permintaan OID sendiri atau mengalihkan permintaan OID yang ada ke adaptor jaringan fisik yang terikat ke adaptor jaringan eksternal. Untuk melakukan ini, ekstensi harus mengikuti langkah-langkah berikut:
Ekstensi memanggil ReferenceSwitchNic untuk menaikkan penghitung referensi untuk indeks adaptor jaringan fisik tujuan. Ini menjamin bahwa antarmuka sakelar yang dapat diperluas tidak akan menghapus koneksi adaptor jaringan fisik sementara penghitung referensinya bukan nol.
Catatan Antarmuka sakelar yang dapat diperluas dapat memutuskan koneksi adaptor jaringan fisik sementara penghitung referensinya bukan nol. Untuk informasi selengkapnya, lihat Hyper-V Extensible Switch Port dan Status Adaptor Jaringan.
Ekstensi merangkum permintaan OID dengan menginisialisasi struktur NDIS_SWITCH_NIC_OID_REQUEST dengan cara berikut:
Anggota DestinationPortId harus diatur ke pengidentifikasi port sakelar yang dapat diperluas tempat adaptor jaringan eksternal tersambung.
Anggota DestinationNicIndex harus diatur ke nilai indeks bukan nol dari adaptor jaringan fisik yang mendasar.
Jika ekstensi berasal atas nama partisi turunan Hyper-V, SourcePortId dan anggota SourceNicIndex diatur ke nilai yang sesuai untuk port dan adaptor jaringan yang digunakan oleh partisi. Jika tidak, SourcePortId dan SourceNicIndex diatur ke nol.
Misalnya, jika ekstensi mengelola sumber daya offload perangkat keras untuk partisi anak, ekstensi harus mengatur SourcePortId dan sourceNicIndex anggota untuk menentukan partisi mana yang menjadi tujuan offload perangkat keras yang dienkapsulasi permintaan OID.
Anggota OidRequest harus diatur ke penunjuk ke struktur NDIS_OID_REQUEST yang diinisialisasi untuk permintaan OID yang dienkapsulasi.
Ekstensi memanggil NdisFOidRequest untuk meneruskan permintaan OID ke port sakelar dan adaptor jaringan yang dapat diperluas tujuan yang ditentukan.
Ketika NDIS memanggil fungsi FilterOidRequestComplete, ekstensi memanggil DereferenceSwitchNic untuk menghapus penghitung referensi untuk indeks adaptor jaringan fisik tujuan.
Mengembalikan Kode Status
Tepi miniport yang mendasar dari sakelar yang dapat diperluas menyelesaikan permintaan kueri OID OID_SWITCH_NIC_REQUEST dan mengembalikan salah satu kode status berikut.
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_ Xxx |
Permintaan gagal karena alasan lain. |
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |