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.
Ekstensi sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_SWITCH_PORT_PROPERTY_ENUM untuk mendapatkan array. Array ini berisi kebijakan port yang disediakan yang cocok dengan kriteria yang ditentukan. Setiap elemen dalam array menentukan properti kebijakan untuk port sakelar yang dapat diperluas tertentu.
InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:
Struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS yang menentukan parameter untuk enumerasi kebijakan port tertentu.
Array struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO. Masing-masing struktur ini berisi informasi tentang properti kebijakan port switch yang dapat diperluas.
Catatan Jika NumProperties anggota struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS diatur ke nol, tidak ada struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO yang dikembalikan.
Komentar
Sebelum mengeluarkan permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM, ekstensi sakelar yang dapat diperluas harus mengikuti panduan berikut:
Ekstensi hanya dapat mengeluarkan permintaan OID_SWITCH_PORT_PROPERTY_ENUM setelah tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID_SWITCH_PORT_CREATE dan sebelum mengeluarkan permintaan OID_SWITCH_PORT_TEARDOWN.
Ekstensi harus memanggil ReferenceSwitchPort sebelum memanggil NdisFOidRequest untuk mengeluarkan permintaan OID_SWITCH_PORT_PROPERTY_ENUM. Ini memastikan bahwa port yang ditentukan tidak akan dihapus sampai setelah permintaan OID selesai.
Setelah permintaan OID selesai, ekstensi harus memanggil DereferenceSwitchPort. Ekstensi harus memanggil fungsi ini terlepas dari apakah permintaan OID diselesaikan dengan NDIS_STATUS_SUCCESS.
OID OID_SWITCH_PORT_PROPERTY_ENUM hanya boleh dikeluarkan ketika sakelar yang dapat diperluas Hyper-V telah menyelesaikan aktivasi. Silakan lihat Mengkueri Konfigurasi Sakelar yang Dapat Diperluas Hyper-V untuk detail selengkapnya.
Catatan Jika ekstensi menerima permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM, ekstensi tidak boleh menyelesaikan permintaan OID. Sebagai gantinya, ia harus memanggil NdisFOidRequest untuk meneruskan permintaan OID ke tumpukan driver sakelar yang dapat diperluas.
Mengembalikan Kode Status
Tepi miniport yang mendasar dari sakelar yang dapat diperluas menyelesaikan permintaan kueri OID OID_SWITCH_PORT_PROPERTY_ENUM dan mengembalikan kode status berikut.
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO
NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS
Mengkueri Konfigurasi Sakelar yang Dapat Diperluas Hyper-V