Bagikan melalui

Mengelola Informasi Status Fitur Port Kustom

  • Artikel

Antarmuka sakelar yang dapat diperluas Hyper-V menggunakan pengidentifikasi objek (OID) berikut untuk mengkueri informasi status kustom untuk port sakelar yang dapat diperluas. Informasi status ini dikenal sebagai informasi status fitur port :

OID_SWITCH_PORT_FEATURE_STATUS_QUERY
Permintaan metode OID ini dikeluarkan oleh tepi protokol sakelar yang dapat diperluas untuk mendapatkan informasi status fitur kustom untuk properti port tertentu.

Setelah berhasil mengembalikan dari permintaan metode OID ini, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer. Buffer ini berisi data berikut:

  • Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS yang menentukan informasi status fitur kustom yang akan dikembalikan.

    Catatan Untuk status fitur kustom, anggota FeatureStatusType diatur ke NdisSwitchPortPropertyTypeCustom.

  • Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM yang berisi informasi status tentang properti kustom yang ditetapkan ke port sakelar yang dapat diperluas.

    Ketika tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan OID_SWITCH_PORT_FEATURE_STATUS_QUERY , itu mengatur anggota FeatureStatusCustomBufferLength dan FeatureStatusCustomBufferOffset ke lokasi di anggota InformationBuffer yang dapat digunakan ekstensi untuk mengembalikan informasi status fitur.

Ekstensi sakelar yang dapat diperluas harus mengikuti panduan ini saat menerima permintaan metode OID OID_SWITCH_PORT_FEATURE_STATUS_QUERY:

  • Ekstensi harus menangani permintaan OID jika mengelola properti port sakelar kustom yang dapat diperluas yang cocok dengan anggota FeatureStatusId dari struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS .

  • Jika ekstensi menangani permintaan metode OID, ekstensi harus mengembalikan informasi status fitur yang cocok dengan parameter yang ditentukan oleh struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS .

    Jika buffer status fitur terlalu kecil, ekstensi harus gagal dalam permintaan OID dengan NDIS_STATUS_INVALID_LENGTH. Ekstensi harus mengatur DATA. SET_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.

    Jika tidak, ekstensi harus mengembalikan informasi status fitur dan menyelesaikan permintaan OID dengan NDIS_STATUS_SUCCESS.

  • Jika ekstensi tidak mengelola properti sakelar yang dapat diperluas kustom, ekstensi harus memanggil NdisFOidRequest untuk meneruskan permintaan OID ke tumpukan driver sakelar yang dapat diperluas.

    Untuk informasi selengkapnya tentang cara meneruskan permintaan OID, lihat Memfilter Permintaan OID di Driver Filter NDIS.

Untuk informasi selengkapnya tentang cara menentukan dan mendaftarkan informasi status fitur port, lihat Status Fitur Port Kustom.