NDF İşlevselliğini Kullanma

Microsoft, genel API aracılığıyla NDF işlevselliğine erişim sağlar. Bir sorun oluştuğunda, uygulama belirli bir uygulama bağlamında bu işlevden yararlanmak için bu API'yi kullanabilir.

NDF ile tanılama gerçekleştirmenin üç aşaması vardır: bir olay oluşturma, tanılama ve onarımların yürütülmesi, ve olayı kapatma. Bu genel bakış, belirli bir senaryo için hangi NDF işlevlerinin uygun olabileceğini gösterir. Her işlevle ilgili ayrıntılı bilgileri NDF Referansı bölümünde bulabilirsiniz.

Olay Oluşturma

NDF tanı oturumu, tanı koymak için belirli bir olay gerektirir. Olay oluşturmak için kullanılabilecek birkaç işlev vardır. Hata oluştuğunda uygulamanın yapmaya çalıştığı işlemle en yakın eşleşen işlevi seçin.

• NdfCreateConnectivityIncident: Ek bilgi gerektirmeyen genel İnternet bağlantısı sorunları.
• NdfCreateWebIncident/NdfCreateWebIncidentEx: HTTP veya HTTPS URL'sine bağlanma.
• NdfCreateSharingIncident: UNC yoluna veya dosya paylaşımına erişme.
• NdfCreateDNSIncident: DNS ana bilgisayar adını çözümleme.
• NdfCreatePnrpIncident: PNRP eş adını çözümleme.
• NdfCreateGroupingIncident: Eşler arası gruba katılma.
• NdfCreateWinSockIncident: Bir yuva kullanarak hedefe bağlanma (diğer işlevlerin hiçbiri özel olarak geçerli olmadığında).
• NdfCreateIncident: Başka bir senaryo uygun olmadığında ve çağrılacak belirli NDF yardımcı sınıfı bilindiğinde kullanılır (gerekli bağımsız değişkenlerle birlikte). Öncelikle kendi yardımcı sınıfını yazan uygulama geliştiricileri tarafından test amacıyla kullanılır.

Tanılama ve Onarımları Çalıştırma

Tanılama ve onarım işlevini başlatmanın iki yolu vardır.

• Windows Kullanıcı Arabirimini Kullanma (Önerilen)

  Standart Windows kullanıcı arabiriminde çalışırken, NdfExecuteDiagnosis işlevini çağırabilirsiniz. NDF Sihirbazı başlatılır ve kullanıcıya sorunu tanımlama (ve mümkünse çözme) konusunda yardımcı olur. Bu işlem tamamlandıktan sonra işlev geri dönecektir. Kullanıcı arabirimi, uygulamanızda isteğe bağlı olarak modal olabilir.

• Özel Kullanıcı Arabirimi Kullanma (yalnızca Windows 7 ve üzeri)

  Kullanıcı arabiriminin gösterilmediği veya standart Windows deneyiminin kullanılmadığı senaryolarda (Media Center, katıştırılmış uygulamalar ve komut istemi gibi) farklı işlevler kullanılabilir. Bu seçenek, NDF Sihirbazı'nda sağlanan kullanıcı deneyimi işlevselliğini atlar. Bu işlev, sonuçları tam olarak desteklenen kök nedenlerle sınırlamanın yanı sıra kullanıcıya onarımları önerilen sırayla sunmak için buluşsal yöntemleri içerir. Bu işlevleri kullanırken, bu tür işlevleri kendiniz sağlamanız gerekir. Ayrıca tanılama sonuçları tarafından kullanılan belleği boşaltmayı da unutmayın.

  Tanılamaya başlamak için NdfDiagnoseIncident işlevini çağırın. Bulunan tüm sorunlar, tanımlanan kök nedenleri ve olası onarımları açıklayan RootCauseInfo yapılarından oluşan bir koleksiyon olarak uygulamaya döndürülür.

  Onarımı seçtikten (veya kullanıcıdan onarımı seçmesini istedikten) sonra, onarımı deneyip sorunun çözülüp çözülmediğini belirlemek için NdfRepairIncidentçağrılmalıdır.

  Bazı durumlarda, onarım başarıyla gerçekleştirilebilir ancak sorunu çözmez. Böyle durumlarda, mevcut olayın kapatılması ve ardından yeni bir olay açılması önerilir. Bu, ilk onarımda maskesi kaldırılan tüm yeni sorunların tanımlanmasını sağlar. Örneğin, görünür kablosuz ağ olmadığını varsayalım. Bağdaştırıcı sıfırlandıktan sonra kablosuz ağlar görünür, ancak hiçbiri tercih edilenler listesinde yer almiyor. Bu, tanımlamak için yeni bir tanılama gerektiren yeni bir sorundur. Böyle ikinci bir tanılama girişimi ek sorunları tanımlamıyorsa, özgün sorunu çözmek için farklı bir onarım denenebilir veya kullanıcıya sorunun çözülemediği bildirilebilir.

  NdfDiagnoseIncident ve NdfRepairIncident zaman uyumlu API'lerdir. Bu işlevler tarafından başlatılan etkinliği iptal etmek istiyorsanız, başka bir iş parçacığından NdfCancelIncident çağırın. İşlev, tanılama veya onarım sürecindeki bir sonraki uygun durdurma noktasına geri dönecektir.

  Herhangi bir noktada, geçerli tanılama oturumu için NDF günlüğünün bir kopyasını almak ve uygulama günlüklerinize eklemek için isteğe bağlı olarak ndfGetTraceFileçağırabilirsiniz. Günlük bir kez kaydedildikten sonra temizlenir ve sonraki çağrılar yalnızca bu işlev için en son yapılan çağrıdan sonra meydana gelen olayları alır.

Bir Olayı Sonlandırma

Bir olayı tanılamayı bitirdiğinizde, NdfCloseIncident çağırarak bu olay üzerinde tanılama gerçekleştirmeyle ilişkili sistem kaynaklarını serbest bırakın. (Bunun NdfDiagnoseIncidenttarafından oluşturulan nesneleri boşaltmadığını unutmayın.