OID_SWITCH_NIC_SAVE

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 çalışma zamanı verilerini kaydetme işlemi sırasında OID_SWITCH_NIC_SAVE nesne tanımlayıcısı (OID) yöntemi isteğinde bulunur. Uzantı, çalışma zamanı verilerinin daha sonra kaydedilebilmesi ve geri yüklenebilmesi için bu verileri döndürür. Çalışma zamanı verileri kaydedildikten sonra, OID_SWITCH_NIC_RESTOREOID kümesi istekleri aracılığıyla geri yüklenir.

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_SAVE OID yöntemi isteğini aldığında, genişletilebilir anahtar uzantısı aşağıdakileri yaparak çalışma zamanı verilerini kaydeder:

• Uzantı, SaveDataOffset bayttan başlayarak verileri yapının başından başlayarak NDIS_SWITCH_NIC_SAVE_STATE yapısı içinde kaydeder.

• Sağlanan SaveDataSize gerekli kaydetme verilerini tutacak kadar büyük değilse, uzantı yöntem yapısının BytesNeeded alanını NDIS_SIZEOF_NDIS_SWITCH_NIC_SAVE_STATE_REVISION_1 olarak ve kaydetme verilerini tutmak için gereken arabellek miktarına ayarlar ve OID'yi NDIS_STATUS_BUFFER_TOO_SHORT ile tamamlar. OID, gerekli boyutla yeniden sunulacaktır.

• Uzantı, ExtensionId ve ExtensionFriendlyName alanlarını kendi tanımlayıcısı ve adıyla doldurur ve OID yöntemi isteğini NDIS_STATUS_SUCCESS ile tamamlar. Bu, genişletilebilir anahtarın protokol kenarının uzantının daha fazla kaydetme verisi döndürmesine veya diğer uzantıların kendi verilerini kaydetmesine izin vermek için başka bir OID yöntemi isteği göndermesine neden olur.

Not Uzantının kaydedilecek çalışma zamanı verileri yoksa, bu OID yöntemi isteğini genişletilebilir anahtar sürücüsü yığınındaki temel uzantılara iletmek için NdisFOidRequest çağrısı yapmalıdır. Bu yordam hakkında daha fazla bilgi için bkz. NDIS Filtre Sürücüsünde OID İsteklerini Filtreleme.

Hyper-V genişletilebilir anahtar, OID'yi vermeden önce Üst Bilgisi, PortId, NicIdex, SaveDataSizeve SaveDataOffset alanlarını doldurur. Uzantı bu alanları değiştiremez.

OID_SWITCH_NIC_SAVE OID yöntemi istekleri sonuçta genişletilebilir anahtarın temel alınan miniport kenarı tarafından işlenir. Bu OID yöntemi isteği genişletilebilir anahtarın miniport kenarı tarafından alındıktan sonra OID isteğini NDIS_STATUS_SUCCESS ile tamamlar. Bu, genişletilebilir anahtarın protokol kenarına, genişletilebilir anahtar sürücü yığınındaki tüm uzantıların çalışma zamanı verileri için sorgulandığını bildirir. Genişletilebilir anahtarın protokol kenarı, kaydetme işlemini tamamlamak için OID_SWITCH_NIC_SAVE_COMPLETE OID kümesi isteği oluşturur.

Genişletilebilir anahtar bağlantı noktası için çalışma zamanı verilerini kaydetme hakkında daha fazla bilgi için bkz. Kaydetme Hyper-V Genişletilebilir Anahtar Run-Time Veri.

İade Durum Kodları

Genişletilebilir anahtar uzantısı, OID_SWITCH_NIC_SAVE OID yöntemi isteği için aşağıdaki durum kodlarından birini döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_BUFFER_TOO_SHORT	Bilgi arabelleğinin uzunluğu NDIS_SWITCH_NIC_SAVE_STATE ve ilişkili çalışma zamanı verileri için çok küçük Genişletilebilir anahtar uzantısının DATA'yı ayarlaması gerekir. METHOD_INFORMATION. BytesNeeded üyesi NDIS_OID_REQUEST yapısında gereken en düşük arabellek boyutuna.
NDIS_STATUS_SUCCESS	Uzantı, kaydetmek için çalışma zamanı verilerini döndürüyorsa bu durumu döndürür.
xxxNDIS_STATUS_	İstek başka nedenlerle başarısız oldu.

Genişletilebilir anahtarın temel alınan miniport kenarı, OID_SWITCH_NIC_SAVE OID yöntemi isteği için aşağıdaki durum kodunu döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_SUCCESS	OID isteği başarıyla tamamlandı.

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

OID_SWITCH_NIC_RESTORE

OID_SWITCH_NIC_SAVE_COMPLETE