OID_SWITCH_PORT_PROPERTY_ADD
Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PORT_PROPERTY_ADD untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang penambahan properti kebijakan untuk port sakelar yang dapat diperluas.
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:
Struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS yang menentukan identifikasi dan jenis parameter untuk kebijakan port.
Buffer properti yang berisi parameter untuk kebijakan port. Buffer properti berisi struktur yang didasarkan pada anggota PropertyType dari struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Misalnya, jika anggota PropertyType diatur ke NdisSwitchPortPropertyTypeVlan, buffer properti berisi struktur NDIS_SWITCH_PORT_PROPERTY_VLAN .
Keterangan
Ekstensi penerusan dapat menangani permintaan set OID_SWITCH_PORT_PROPERTY_ADD OID. Semua jenis ekstensi lainnya harus memanggil NdisFOidRequest untuk meneruskan permintaan OID ke ekstensi berikutnya di tumpukan driver sakelar yang dapat diperluas.
Ekstensi dapat melakukan veto pada penambahan properti port dengan mengembalikan NDIS_STATUS_DATA_NOT_ACCEPTED untuk permintaan OID. Misalnya, jika ekstensi tidak dapat mengalokasikan sumber daya untuk menerapkan kebijakan yang dikonfigurasi pada port, ekstensi harus mem-veto permintaan penambahan.
Catatan Jika ekstensi mengembalikan kode status kesalahan NDIS_STATUS_Xxx lainnya , pemberitahuan pembuatan juga di-veto. Namun, mengembalikan kode status untuk skenario transitori, seperti mengembalikan NDIS_STATUS_RESOURCES, dapat mengakibatkan coba lagi pemberitahuan pembuatan.
Jika ekstensi tidak mem-veto permintaan OID, ekstensi harus memantau status ketika permintaan selesai. Ekstensi harus melakukan ini untuk menentukan apakah permintaan OID di-veto dengan ekstensi yang mendasar di jalur kontrol sakelar yang dapat diperluas atau oleh antarmuka sakelar yang dapat diperluas.
Untuk panduan tentang cara menangani permintaan set OID_SWITCH_PORT_PROPERTY_ADD OID, lihat Mengelola Kebijakan Port.
Mengembalikan Kode Status
Jika ekstensi penerusan menyelesaikan permintaan set OID OID_SWITCH_PORT_PROPERTY_ADD, ekstensi tersebut mengembalikan salah satu kode status berikut:
Kode Status | Deskripsi |
---|---|
NDIS_STATUS_INVALID_LENGTH |
Panjang buffer informasi terlalu kecil untuk memproses struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dan data dalam buffer properti struktur. Ekstensi mengatur DATA. SET_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan. |
NDIS_STATUS_DATA_NOT_ACCEPTED |
Ekstensi penerusan telah mem-veto pemberitahuan penambahan kebijakan port. |
NDIS_STATUS_NOT_SUPPORTED |
Ekstensi penerusan tidak mendukung kebijakan port. |
NDIS_STATUS_Xxx |
Permintaan OID gagal karena alasan lain. |
Jika ekstensi tidak menyelesaikan permintaan set OID OID_SWITCH_PORT_PROPERTY_ADD, permintaan diselesaikan oleh tepi miniport yang mendasar dari sakelar yang dapat diperluas. Tepi miniport 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_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk