Özel Anahtar Özellik Durumu Bilgilerini Yönetme

Hyper-V genişletilebilir anahtar arabirimi, genişletilebilir anahtarın özel durum bilgilerini sorgulamak için aşağıdaki nesne tanımlayıcısını (OID) kullanır. Bu durum bilgisi, anahtarı özellik durumu bilgisi olarak bilinir.

OID_ANAHTAR_ÖZELLİK_DURUMU_SORGULAMA
Bu OID yöntem isteği, belirtilen anahtar özelliğinin özel durum bilgilerini almak için genişletilebilir anahtarın protokol ucu tarafından verilir.

Bu OID yöntemi isteğinden başarılı bir dönüşten sonra, NDIS_OID_REQUEST yapısının InformationBuffer üyesi, arabelleğe bir işaretçi taşır. Bu arabellek aşağıdaki verileri içerir:

• Döndürülmesi gereken özel özellik durum bilgilerini belirten bir NDIS_SWITCH_FEATURE_STATUS_PARAMETERS yapısı.

  Not Özel özellik durumu için FeatureStatusType üyesi NdisSwitchPropertyTypeCustom olarak ayarlanır.

• Genişletilebilir anahtar bağlantı noktasına atanan özel özellik hakkındaki durum bilgilerini içeren NDIS_SWITCH_FEATURE_STATUS_CUSTOM yapısı.

  Genişletilebilir anahtarın protokol kenarı OID_SWITCH_FEATURE_STATUS_QUERY isteğini gönderdiğinde, FeatureStatusCustomBufferLength ve FeatureStatusCustomBufferOffset üyelerini, uzantının özellik durumu bilgilerini döndürmek için kullanabileceği InformationBuffer üyesindeki bir konuma ayarlar.

Genişletilebilir anahtar uzantısı, OID_SWITCH_FEATURE_STATUS_QUERYOID yöntemi isteği aldığında şu yönergeleri izlemelidir:

• Uzantı, NDIS_SWITCH_FEATURE_STATUS_PARAMETERS yapısının FeatureStatusId üyesiyle eşleşen özel bir genişletilebilir anahtar özellik durumunu yönetiyorsa OID isteğini işlemelidir.

• Uzantı OID yöntemi isteğini işlerse, NDIS_SWITCH_FEATURE_STATUS_PARAMETERS yapısı tarafından belirtilen parametrelerle eşleşen özellik durumu bilgilerini döndürmesi gerekir.

  Özellik durumu arabelleği yeterince küçükse, uzantı OID isteğini NDIS_STATUS_INVALID_LENGTH ile başarısız yapmalıdır. Eklentinin, DATA.SET_INFORMATION.BytesNeeded üyesini, NDIS_OID_REQUEST yapısındaki gereken asgari arabellek boyutuna ayarlaması gerekir.

  Aksi takdirde uzantının özellik durumu bilgilerini döndürmesi ve OID isteğini NDIS_STATUS_SUCCESS ile tamamlaması gerekir.

• Uzantı özel genişletilebilir anahtar özellik durumunu yönetmezse, OID isteğini genişletilebilir anahtar sürücü yığınına iletmek için NdisFOidRequest çağırması gerekir.

  OID isteklerini iletme hakkında daha fazla bilgi için bkz. NDIS Filtre Sürücüsünde OID İsteklerini Filtreleme.

Anahtar özelliği durum bilgilerini tanımlama ve kaydetme hakkında daha fazla bilgi için bkz. Özel Anahtar Özellik Durumu.