OID_SWITCH_NIC_RESTORE
Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_RESTORE untuk memberi tahu ekstensi sakelar yang dapat diperluas tentang data run-time yang dapat dipulihkan untuk port sakelar yang dapat diperluas dan koneksi adaptor jaringannya.
Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_SWITCH_NIC_SAVE_STATE . Struktur ini dialokasikan oleh tepi protokol sakelar yang dapat diperluas.
Keterangan
Ketika menerima permintaan set OID dari OID_SWITCH_NIC_RESTORE, ekstensi sakelar yang dapat diperluas harus terlebih dahulu menentukan apakah ia memiliki data run-time. Ekstensi melakukan ini dengan membandingkan nilai anggota ExtensionId dari struktur NDIS_SWITCH_NIC_SAVE_STATE dengan nilai GUID yang digunakan ekstensi untuk mengidentifikasi dirinya sendiri.
Jika ekstensi memiliki data run-time untuk port sakelar yang dapat diperluas, ekstensi memulihkan data ini dengan cara berikut:
Ekstensi menyalin data run-time di anggota SaveData ke penyimpanan yang dialokasikan ekstensi.
Catatan Nilai anggota PortId dari struktur NDIS_SWITCH_NIC_SAVE_STATE mungkin berbeda dari nilai PortId pada saat data run-time disimpan. Ini dapat terjadi jika data run-time disimpan selama Migrasi Langsung dari satu host ke host lainnya. Namun, konfigurasi port sakelar yang dapat diperluas dipertahankan selama Migrasi Langsung. Ini memungkinkan ekstensi untuk memulihkan data run-time ke port sakelar yang dapat diperluas dengan menggunakan nilai PortId baru.
Ekstensi menyelesaikan permintaan set OID dengan NDIS_STATUS_SUCCESS.
Jika ekstensi tidak memiliki data run-time yang ditentukan, ekstensi memanggil NdisFOidRequest untuk meneruskan permintaan set OID ini ke ekstensi yang mendasari dalam tumpukan driver switch yang dapat diperluas. Dalam hal ini, ekstensi tidak boleh memodifikasi struktur NDIS_SWITCH_NIC_SAVE_STATE yang terkait dengan permintaan OID.
Jika permintaan set OID_SWITCH_NIC_RESTORE diterima oleh tepi miniport sakelar yang dapat diperluas, permintaan OID akan diselesaikan dengan NDIS_STATUS_SUCCESS. Ini memberi tahu tepi protokol sakelar yang dapat diperluas bahwa tidak ada ekstensi yang memiliki data run-time.
Untuk informasi selengkapnya tentang cara memulihkan data run-time, lihat Memulihkan Hyper-V Extensible Switch Run-Time Data.
Catatan Jika ekstensi gagal dalam permintaan set OID, sakelar yang dapat diperluas akan gagal di seluruh operasi pemulihan. Akibatnya, ekstensi harus menghindari kegagalan permintaan OID jika memungkinkan. Misalnya, jika ekstensi tidak dapat mengalokasikan sumber daya yang diperlukan untuk memulihkan data run-time, ekstensi harus gagal dalam permintaan OID jika tidak dapat berfungsi dengan baik tanpa memulihkan data run-time. Namun, jika ekstensi dapat pulih dari kondisi kegagalan, seharusnya tidak gagal permintaan set OID.
Mengembalikan Kode Status
Jika ekstensi menyelesaikan permintaan set OID_SWITCH_NIC_RESTORE OID, ekstensi mengembalikan salah satu kode status berikut.
| Kode Status | Deskripsi |
|---|---|
NDIS_STATUS_SUCCESS |
Permintaan OID berhasil diselesaikan. |
NDIS_STATUS_Xxx |
Permintaan gagal karena alasan lain. |
Persyaratan
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk