OID_SWITCH_PROPERTY_ADD

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_PROPERTY_ADD untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang penambahan properti kebijakan pengalihan

InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:

• Struktur NDIS_SWITCH_PROPERTY_PARAMETERS yang menentukan identifikasi dan jenis kebijakan sakelar yang dapat diperluas.

• Buffer properti yang berisi parameter untuk kebijakan pengalihan yang dapat diperluas. Buffer properti berisi struktur yang didasarkan pada PropertyType anggota struktur NDIS_SWITCH_PROPERTY_PARAMETERS.

  Catatan Dimulai dengan Windows Server 2012, PropertyType anggota harus diatur ke NdisSwitchPropertyTypeCustom dan buffer properti harus berisi struktur NDIS_SWITCH_PROPERTY_CUSTOM.

Komentar

Ekstensi penerusan dapat menangani permintaan set OID_SWITCH_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 mem-veto penambahan properti switch dengan mengembalikan NDIS_STATUS_DATA_NOT_ACCEPTED untuk permintaan OID. Misalnya, jika ekstensi tidak dapat mengalokasikan sumber daya untuk menerapkan kebijakan yang diperbarui pada sakelar, ekstensi tersebut 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 percobaan kembali 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 oleh 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_PROPERTY_ADD OID, lihat Mengelola Kebijakan Pengalihan.

Mengembalikan Kode Status

Jika ekstensi penerusan menyelesaikan permintaan set OID_SWITCH_PROPERTY_ADD OID, ekstensi tersebut mengembalikan salah satu kode status berikut.

Kode Status	Deskripsi
NDIS_STATUS_DATA_NOT_ACCEPTED	Ekstensi telah mem-veto pemberitahuan penambahan kebijakan pengalihan.
NDIS_STATUS_FAILURE	Permintaan OID gagal karena alasan lain.

Jika ekstensi tidak menyelesaikan permintaan set OID OID_SWITCH_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_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest