OID_SWITCH_NIC_RESTORE

Hyper-V genişletilebilir anahtarın protokol kenarı, genişletilebilir anahtar bağlantı noktası ve ağ bağdaştırıcısı bağlantısı için geri yüklenebilen çalışma zamanı verileri hakkında genişletilebilir anahtar uzantısını bilgilendirmek üzere OID_SWITCH_NIC_RESTORE nesne tanımlayıcısı (OID) kümesi isteği verir.

NDIS_OID_REQUEST yapısının InformationBuffer üyesi, NDIS_SWITCH_NIC_SAVE_STATE bir yapıya yönelik bir işaretçi içerir. Bu yapı, genişletilebilir anahtarın protokol kenarı tarafından ayrılır.

Açıklamalar

OID_SWITCH_NIC_RESTORE OID kümesi isteğini aldığında, genişletilebilir anahtar uzantısının önce çalışma zamanı verilerine sahip olup olmadığını belirlemesi gerekir. Uzantı bunu, NDIS_SWITCH_NIC_SAVE_STATE yapısının ExtensionId üyesinin değerini uzantının kendisini tanımlamak için kullandığı GUID değeriyle karşılaştırarak yapar.

Uzantı, genişletilebilir bir anahtar bağlantı noktası için çalışma zamanı verilerine sahipse, bu verileri aşağıdaki şekilde geri yükler:

1. Uzantı, SaveData üyesindeki çalışma zamanı verilerini uzantı ayrılmış depolama alanına kopyalar.

   NotNDIS_SWITCH_NIC_SAVE_STATE yapısının PortId üyesinin değeri, çalışma zamanı verilerinin kaydedildiği zamandaki PortId değerinden farklı olabilir. Çalışma zamanı verileri bir konaktan diğerine Dinamik Geçiş sırasında kaydedildiyse bu durum oluşabilir. Ancak, Dinamik Geçiş sırasında genişletilebilir anahtar bağlantı noktasının yapılandırması korunur. Bu, uzantının yeni PortId değerini kullanarak çalışma zamanı verilerini genişletilebilir anahtar bağlantı noktasına geri yüklemesini sağlar.

2. Uzantı, OID kümesi isteğini NDIS_STATUS_SUCCESS ile tamamlar.

Uzantı belirtilen çalışma zamanı verilerine sahip değilse, uzantı bu OID kümesi isteğini genişletilebilir anahtar sürücü yığınındaki temel uzantılara iletmek için NdisFOidRequest çağırır. Bu durumda uzantı, OID isteğiyle ilişkili NDIS_SWITCH_NIC_SAVE_STATE yapısını değiştirmemelidir.

OID_SWITCH_NIC_RESTORE kümesi isteği genişletilebilir anahtarın miniport kenarı tarafından alınırsa, OID isteğini NDIS_STATUS_SUCCESS ile tamamlar. Bu, genişletilebilir anahtarın protokol kenarına çalışma zamanı verilerinin hiçbir uzantısının sahip olmadığını bildirir.

Çalışma zamanı verilerini geri yükleme hakkında daha fazla bilgi için bkz. Hyper-V Genişletilebilir Anahtarı Geri Yükleme Run-Time Veri.

Not Uzantı OID kümesi isteğinde başarısız olursa, genişletilebilir anahtar geri yükleme işleminin tamamında başarısız olur. Sonuç olarak, mümkünse uzantının OID isteğini başarısız yapmaktan kaçınması gerekir. Örneğin, uzantı çalışma zamanı verilerini geri yüklemek için gereken kaynağı ayıramıyorsa, çalışma zamanı verilerini geri yüklemeden düzgün çalışamıyorsa OID isteğinin başarısız olması gerekir. Ancak uzantı hata koşulundan kurtarılabiliyorsa OID kümesi isteğinde başarısız olmamalıdır.

İade Durum Kodları

Uzantı OID_SWITCH_NIC_RESTORE OID kümesi isteğini tamamlarsa aşağıdaki durum kodlarından birini döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_SUCCESS	OID isteği başarıyla tamamlandı.
xxxNDIS_STATUS_	İstek başka nedenlerle başarısız oldu.

Gereksinim -leri

Sürüm	NDIS 6.30 ve sonraki sürümlerde desteklenir.
Üstbilgi	Ntddndis.h (Ndis.h içerir)

Ayrıca bkz.

---

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest