OID_SWITCH_NIC_SAVE

Artikel
06/15/2023

Tepi protokol sakelar yang dapat diperluas Hyper-V mengeluarkan permintaan metode pengidentifikasi objek (OID) OID_SWITCH_NIC_SAVE selama operasi untuk menyimpan data run-time untuk port sakelar yang dapat diperluas dan koneksi adaptor jaringannya. Ekstensi mengembalikan data ini sehingga data run-time dapat disimpan dan dipulihkan di lain waktu. Setelah data run-time disimpan, data tersebut dipulihkan melalui permintaan set OID_SWITCH_NIC_RESTORE OID.

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 metode OID dari OID_SWITCH_NIC_SAVE, ekstensi sakelar yang dapat diperluas menyimpan data run-time dengan melakukan hal berikut:

Ekstensi menyimpan data dalam struktur NDIS_SWITCH_NIC_SAVE_STATE mulai dari byte SaveDataOffset dari awal struktur.
Jika SaveDataSize yang disediakan tidak cukup besar untuk menyimpan data penyimpanan yang diperlukan, ekstensi mengatur bidang BytesNeeded struktur metode ke NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 ditambah jumlah buffer yang diperlukan untuk menyimpan data, dan menyelesaikan OID dengan NDIS_STATUS_BUFFER_TOO_SHORT. OID akan diterbitkan kembali dengan ukuran yang diperlukan.
Ekstensi mengisi bidang ExtensionId dan ExtensionFriendlyName dengan pengidentifikasi dan namanya sendiri, dan menyelesaikan permintaan metode OID dengan NDIS_STATUS_SUCCESS. Hal ini menyebabkan tepi protokol sakelar yang dapat diperluas mengeluarkan permintaan metode OID lain untuk memungkinkan ekstensi mengembalikan lebih banyak penyimpanan data, atau memungkinkan ekstensi lain ke bawah tumpukan untuk menyimpan data mereka sendiri.

Catatan Jika ekstensi tidak memiliki data run-time untuk disimpan, ekstensi harus memanggil NdisFOidRequest untuk meneruskan permintaan metode OID ini ke ekstensi yang mendasari dalam tumpukan driver switch yang dapat diperluas. Untuk informasi selengkapnya tentang prosedur ini, lihat Memfilter Permintaan OID di Driver Filter NDIS.

Sakelar Hyper-V yang dapat diperluas mengisi bidang Header, PortId, NicIdex, SaveDataSize , dan SaveDataOffset dari struktur sebelum mengeluarkan OID. Ekstensi tidak dapat mengubah bidang ini.

Permintaan metode OID dari OID_SWITCH_NIC_SAVE pada akhirnya ditangani oleh tepi miniport yang mendasar dari sakelar yang dapat diperluas. Setelah permintaan metode OID ini diterima oleh tepi miniport sakelar yang dapat diperluas, permintaan OID selesai dengan NDIS_STATUS_SUCCESS. Ini memberi tahu tepi protokol sakelar yang dapat diperluas bahwa semua ekstensi dalam tumpukan driver sakelar yang dapat diperluas telah dikueri untuk data run-time. Tepi protokol sakelar yang dapat diperluas kemudian mengeluarkan permintaan set OID OID_SWITCH_NIC_SAVE_COMPLETE untuk menyelesaikan operasi penyimpanan.

Untuk informasi selengkapnya tentang cara menyimpan data run-time untuk port sakelar yang dapat diperluas, lihat Menyimpan Hyper-V Extensible Switch Run-Time Data.

Mengembalikan Kode Status

Ekstensi sakelar yang dapat diperluas mengembalikan salah satu kode status berikut untuk permintaan metode OID OID_SWITCH_NIC_SAVE.

Kode Status	Deskripsi
NDIS_STATUS_BUFFER_TOO_SHORT	Panjang buffer informasi terlalu kecil untuk NDIS_SWITCH_NIC_SAVE_STATE dan data run-time terkait Ekstensi sakelar yang dapat diperluas harus mengatur DATA. METHOD_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_SUCCESS	Ekstensi mengembalikan status ini jika mengembalikan data run-time untuk disimpan.
NDIS_STATUS_Xxx	Permintaan gagal karena alasan lain.