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_PROPERTY_ENUM untuk mendapatkan array. Array ini berisi kebijakan sakelar yang disediakan yang cocok dengan kriteria yang ditentukan. Setiap elemen dalam array menentukan properti kebijakan sakelar yang dapat diperluas.
InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:
Struktur NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS yang menentukan parameter untuk enumerasi kebijakan sakelar yang dapat diperluas.
Array struktur NDIS_SWITCH_PROPERTY_ENUM_INFO. Masing-masing struktur ini berisi informasi tentang kebijakan pengalihan yang dapat diperluas.
Catatan Jika ekstensi belum disediakan dengan instans kebijakan sakelar yang dapat diperluas yang ditentukan, ekstensi menetapkan NumProperties anggota struktur NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS ke nol dan tidak ada struktur NDIS_SWITCH_PROPERTY_ENUM_INFO yang dikembalikan.
Komentar
OID OID_SWITCH_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.
Tidak seperti permintaan kueri OID OID_SWITCH_PORT_PROPERTY_ENUM, ekstensi tidak perlu memanggil ReferenceSwitchXxx atau Fungsi DereferenceSwitchXxx saat mengeluarkan permintaan OID_SWITCH_PROPERTY_ENUM menurunkan tumpukan driver sakelar yang dapat diperluas.
Catatan Jika ekstensi menerima permintaan metode OID OID_SWITCH_PROPERTY_ENUM, ekstensi tersebut 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_PROPERTY_ENUM dan mengembalikan salah satu kode status berikut.
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_INVALID_LENGTH |
Panjang buffer informasi terlalu kecil untuk mengembalikan struktur NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS dan array elemen NDIS_SWITCH_PROPERTY_ENUM_INFO. Tepi miniport yang mendasar dari sakelar yang dapat diperluas mengatur data . METHOD_INFORMATION. BytesNeeded anggota dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan. |
NDIS_STATUS_FAILURE |
Permintaan gagal karena alasan lain. |
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Mengkueri Konfigurasi Sakelar yang Dapat Diperluas Hyper-V