OID_SWITCH_PORT_PROPERTY_UPDATE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PORT_PROPERTY_UPDATE untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang pembaruan properti untuk kebijakan 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 properti 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_UPDATE 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 pembaruan properti port dengan mengembalikan NDIS_STATUS_DATA_NOT_ACCEPTED untuk permintaan OID. Misalnya, jika ekstensi tidak dapat mengalokasikan sumber daya untuk menerapkan kebijakan yang diperbarui pada port, ekstensi harus mem-veto permintaan pembaruan.

Catatan Jika ekstensi mengembalikan kode status kesalahan NDIS_STATUS_Xxx lainnya , pemberitahuan pembaruan 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_UPDATE OID, lihat Mengelola Kebijakan Port.

Mengembalikan Kode Status

Jika ekstensi penerusan menyelesaikan permintaan set OID_SWITCH_PORT_PROPERTY_UPDATE OID, 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 penghapusan 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_UPDATE, permintaan diselesaikan oleh tepi miniport yang mendasar dari sakelar yang dapat diperluas. Tepi miniport mengembalikan kode status berikut.