OID_SWITCH_PROPERTY_ADD

Hyper-V genişletilebilir anahtarın protokol kenarı, genişletilebilir anahtar uzantılarına anahtar ilkesi özelliğinin eklenmesini bildirmek için OID_SWITCH_PROPERTY_ADD nesne tanımlayıcısı (OID) kümesi isteği verir

NDIS_OID_REQUEST yapısının InformationBuffer üyesi arabelleğe bir işaretçi içerir. Bu arabellek aşağıdaki verileri içerir:

• Genişletilebilir bir anahtar ilkesinin kimliğini ve türünü belirten NDIS_SWITCH_PROPERTY_PARAMETERS yapısı.

• Genişletilebilir anahtar ilkesi parametrelerini içeren özellik arabelleği. Özellik arabelleği, NDIS_SWITCH_PROPERTY_PARAMETERS yapısının PropertyType üyesini temel alan bir yapı içerir.

  Not Windows Server 2012'den başlayarak, PropertyType üyesi NdisSwitchPropertyTypeCustom olarak ayarlanmalıdır ve özellik arabelleği NDIS_SWITCH_PROPERTY_CUSTOM bir yapı içermelidir.

Açıklamalar

İletme uzantısı, OID_SWITCH_PROPERTY_ADD OID kümesi isteğini işleyebilir. Diğer tüm uzantı türleri, OID isteğini genişletilebilir anahtar sürücü yığınındaki bir sonraki uzantıya iletmek için NdisFOidRequest çağırmalıdır.

Uzantı, OID isteği için NDIS_STATUS_DATA_NOT_ACCEPTED döndürerek switch özelliğinin eklenmesini veto edebilir. Örneğin, bir uzantı anahtarda güncelleştirilmiş ilkelerini zorunlu kılmak için kaynakları ayıramıyorsa, ekleme isteğini veto etmelidir.

Not Uzantı diğer NDIS_STATUS_Xxx hata durum kodlarını döndürürse, oluşturma bildirimi de veto edilir. Ancak, NDIS_STATUS_RESOURCES döndürme gibi geçici senaryolar için durum kodlarının döndürülmesi, oluşturma bildiriminin yeniden denenmesiyle sonuçlanabilir.

Uzantı OID isteğini veto etmiyorsa, istek tamamlandığında durumu izlemelidir. Uzantı, OID isteğinin genişletilebilir anahtar denetim yolundaki temel uzantılar veya genişletilebilir anahtar arabirimi tarafından veto edilip edilmediğini belirlemek için bunu yapmalıdır.

OID_SWITCH_PROPERTY_ADD OID kümesi isteğini işleme yönergeleri için bkz. Anahtar İlkelerini Yönetme .

İade Durum Kodları

İletme uzantısı OID_SWITCH_PROPERTY_ADD OID kümesi isteğini tamamlarsa, aşağıdaki durum kodlarından birini döndürür.

Durum Kodu	Açıklama
NDIS_STATUS_DATA_NOT_ACCEPTED	Uzantı, anahtar ilkesi ekleme bildirimini veto etti.
NDIS_STATUS_FAILURE	OID isteği başka nedenlerle başarısız oldu.

Uzantı OID_SWITCH_PROPERTY_ADD OID kümesi isteğini tamamlamazsa, istek genişletilebilir anahtarın temel alınan miniport kenarı tarafından tamamlanır. Miniport kenarı 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_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest