OID_SWITCH_PROPERTY_ADD

  • Artikel

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

Anggota InformationBuffer dari 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 sakelar yang dapat diperluas. Buffer properti berisi struktur yang didasarkan pada anggota PropertyType dari struktur NDIS_SWITCH_PROPERTY_PARAMETERS .

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

Keterangan

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 melakukan veto pada 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 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_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