INF AddSoftware yönergesi

Her AddSoftware yönergesi, tek başına yazılımın yüklenmesini açıklar. Bu yönerge, SoftwareComponent kurulum sınıfının BIR INF dosyasında kullanılmalıdır. Yazılım bileşenleri hakkında daha fazla bilgi için bkz. Bileşen INF Dosyası Kullanma. Bu yönerge Windows 10 sürüm 1703 ve üzeri için desteklenir.

Geçerli yükleme türleri, hedef platformbağlıdır. Örneğin, Masaüstü MSI yükleyicilerini destekler ve EXE'leri ayarlar.

Uyarı

Tür 2 Evrensel Sürücüler'de desteklenir, Tür 1 yalnızca masaüstüdür.

Bir yazılım bileşeni INF dosyası addSoftware belirttiğinde, sistem, cihaz yüklendikten sonra yüklenecek yazılımları kuyruğa alır. Yazılımın ne zaman veya ne zaman yükleneceğinin garantisi yoktur. Başvuruda bulunan yazılım yüklenemezse, başvuran yazılım bileşeni güncelleştirildiğinde sistem yeniden dener.

AddSoftware yönergesi, INF DDInstalliçinde kullanılır. Yazılım bölümü.

[DDInstall.Software]
AddSoftware=SoftwareName,[flags],software-install-section

Giriş

SoftwareName
Yüklenecek yazılımın adını belirtir. Bu ad, INF veya bölüm adından bağımsız olarak sistem genelinde benzersiz olmalıdır. bir AddSoftware yönergesinin işlenmesi, herhangi bir sürücü paketinden bir AddSoftware yönergesi tarafından aynı ada sahip önceki yazılımlara karşı sürümü denetler. SoftwareName'i satıcı adıyla önceden adlandırmanızı öneririz, örneğin ContosoControlPanel.

bayrakları
Bir veya daha fazla (ORed) bayrağı belirtir.

0x00000000
AddSoftware yönergesi yalnızca bir kez işlenir.

0x00000001
AddSoftware yönergesi, aynı benzersiz SoftwareNameile AddSoftware belirten her bileşen cihazı için bir kez işlenir.

Örneğin, aynı INF dosyası kullanılarak üç cihazın yüklendiği bir yapılandırma düşünün. Yazılım yükleme işlemi 0x00000000 bayrakları için yalnızca bir kez, 0x00000001 bayrakları için üç kez çalışır.

yazılım yükleme bölümü
Yazılım yükleme bilgilerini içeren INF yazıcı tanımlı bir bölüme başvurur.

Açıklamalar

INF yazıcısı tarafından oluşturulan her bölüm adı, INF dosyasında benzersiz olmalıdır ve bölüm adlarını tanımlamak için genel kurallara uymalıdır. Bu kurallar hakkında daha fazla bilgi için bkz. INF Dosyaları için Genel Sözdizimi Kuralları.

AddSoftware yönergesi, INF dosyasının başka bir yerindeki adlandırılmış software-install-section başvurmalıdır. Bu tür bölümlerin her birinde aşağıdaki form vardır:

[software-install-section]

SoftwareType=type-code
[SoftwareBinary=path-to-binary]
[SoftwareArguments=argument[, argument] …]
[SoftwareVersion=w.x.y.z]
[SoftwareID=pfn://x.y.z]

Uyarı

Bölüm girdileri ve değerleriyle ilgili kısıtlamalar hakkında bilgi için bkz. SoftwareType.

AddSoftware kullanılarak yüklenen tüm yazılımlar sessizce (veya sessizce) yüklenmelidir. Başka bir deyişle, yükleme sırasında kullanıcıya hiçbir kullanıcı arabirimi gösterilmez.

AddSoftware kullanılarak yüklenen tüm yazılımlar, sanal yazılım bileşeni cihazı veya üst cihazları kaldırılırsa kaldırılmaz. Yazılımınız bir UWP uygulaması değilse (yani, 1 SoftwareType ile AddSoftware kullanıyorsanız), lütfen kullanıcıların kayıt defterinde bir iz bırakmadan kolayca kaldıradığından emin olun. Bunu yapmak için:

• MSI yükleyicisi kullanıyorsanız, uygulamanın Windows Installer paketinde Program Ekle/Kaldır bir oluşturun.

• Genel kayıt defteri/dosya durumunu yükleyen özel bir EXE kullanıyorsanız (yerel cihaz ayarlarını desteklemek yerine), kayıt defteri anahtarını kaldırma kullanın.

Yazılım yükleme bölümü girdileri ve değerleri

SoftwareType={type-code}
SoftwareType, yazılım yüklemesinin türünü belirtir ve gerekli bir girdidir.

1 değeri, ilişkili yazılımın bir MSI veya EXE ikili dosyası olduğunu gösterir. Bu değer ayarlandığında, SoftwareBinary girişi de gereklidir. Windows 10 S'de 1 değeri desteklenmez.

SoftwareType 1 olarak ayarlanırsa, SoftwareBinary ve SoftwareVersion de gereklidir, ancak SoftwareArguments ve bayrakları (AddSoftware yönergesinde) isteğe bağlıdır.

Windows 10 sürüm 1709'dan başlayarak, 2 değeri ilişkili yazılımın bir Microsoft Store bağlantısı olduğunu gösterir. Yalnızca grafik kullanıcı arabirimi olmayan cihaza özgü yazılımlar için 1 değerini kullanın. Grafik öğeleri olan cihaza özgü bir uygulamanız varsa, bu uygulama Microsoft Store'dan gelmelidir ve sürücü 2 SoftwareType değeri kullanarak buna başvurmalıdır.

SoftwareType 2 olarak ayarlanırsa, SoftwareID gerekir ve bayrakları (AddSoftware yönergesinde) isteğe bağlıdır. SoftwareType 2 olarak ayarlanırsa, SoftwareBinary ve SoftwareVersion kullanılmaz.

Uyarı

AddSoftware yönergesinin SoftwareType 2 kullanırken, Bileşen INF'sini kullanmak gerekli değildir. yönergesi herhangi bir INF'de başarıyla kullanılabilir. Bununla birlikte, Bir Bileşen INF'sinden Tür 1'in AddSoftware yönergesi kullanılmalıdır.

AddSoftware'i bir cihazla ilgisi olmayan yazılımları dağıtmak için kullanmayın. Örneğin, OEM'e özgü bir bilgisayar yardımcı programı AddSoftware ile yüklenmemelidir. Bunun yerine, bir uygulamayı Windows 10'un OEM görüntüsüne önceden yüklemek için aşağıdaki seçeneklerden birini kullanın:

• Win32 uygulamasını önceden yüklemek için denetim moduna önyükleme yapıp uygulamayı yükleyin. Ayrıntılar için bkz. Denetim Moduna Genel Bakış.

• Microsoft Store (UWP) uygulamasını önceden yüklemek için bkz. Masaüstü cihazlar için önceden yüklenmiş uygulamalar

Bir sürücüyü Evrensel Windows Platformu (UWP) uygulamasıyla eşleştirme hakkında bilgi için bkz. Evrensel Windows Platformu (UWP) uygulamasıyla sürücü eşleştirme ve Donanım Destek Uygulaması (HSA): Sürücü Geliştiricileriiçin adımlar.

SoftwareBinary={filename}
Yürütülebilir dosyanın yolunu belirtir. Sistem aşağıdaki gibi komut satırları oluşturur:

MSI: msiexec /i "<SoftwareBinary>" ALLUSERS=1 /quiet /qn /promptrestart [<SoftwareArguments>]

EXE: <SoftwareBinary> [<SoftwareArguments>]

Bu girdiyi kullanırsanız, 13 olan DestinationDirs değeriyle INF CopyFiles Yönergesi belirterek yürütülebilir dosyayı DriverStore'ya eklemeniz gerekir.

Uyarı

SoftwareBinary girdileri ve değerleriyle ilgili kısıtlamalar hakkında bilgi için bkz. SoftwareType.

SoftwareArguments={argument1[, argument2[, ... argumentN]]}
Komut satırına eklenecek uzantıya özgü bağımsız değişkenleri belirtir. Sistemin yalnızca oluşturulan komut satırına geçirdiği komut satırı bağımsız değişkenlerini belirtebilirsiniz. çalışma zamanı bağlam değişkenleri olarak adlandırılan özel dizeler de belirtebilirsiniz. Bir çalışma zamanı bağlam değişkeni belirttiğinizde, sistem bunu oluşturulan komut satırına eklemeden önce cihaza özgü bir değere dönüştürür. Değişmez dize bağımsız değişkenlerini çalışma zamanı bağlam değişkenleriyle karıştırabilir ve eşleştirebilirsiniz. Desteklenen çalışma zamanı bağlam değişkenleri şunlardır:

<<DeviceInstanceID>>

Sistem, yukarıdaki dizeyi yazılım bileşeninin cihaz örneği kimliğiyle değiştirir.

Örneğin:

    [DDInstall.Software]
    AddSoftware=ContosoControlPanel,,Contoso_ControlPanel_Software

    [Contoso_ControlPanel_Software]
    SoftwareType=1
    SoftwareBinary=ContosoControlPanel.exe
    SoftwareArguments=<<DeviceInstanceID>>
    SoftwareVersion=1.0.0.0

Yukarıdaki örnekte aşağıdaki gibi bir komut satırı elde edin:

<DriverStorePath>\ContosoControlPanel.exe PCI\VEN_0000&DEV_0001&SUBSYS_00000000&REV_00\0123

SoftwareArguments birden çok bağımsız değişken içeriyorsa:

    SoftwareArguments=arg1,<<DeviceInstanceID>>,arg2

Yukarıdaki sonuçlar:

<DriverStorePath>\ContosoControlPanel.exe arg1 PCI\VEN_0000&DEV_0001&SUBSYS_00000000&REV_00\0123 arg2

Uyarı

SoftwareArguments girdileri ve değerleriyle ilgili kısıtlamalar hakkında bilgi için bkz. SoftwareType.

SoftwareVersion={w.x.y.z}
Yazılım sürümünü belirtir. Her değer 65535'i aşmamalıdır. Sistem, SoftwareName yinelenen birkarşılaştığında, SoftwareVersion önceki SoftwareVersionkarşı denetler. Daha büyükse, Windows yazılımı çalıştırır.

Uyarı

SoftwareVersion girdileri ve değerleriyle ilgili kısıtlamalar hakkında bilgi için bkz. SoftwareType.

SoftwareID={x.y.z}
Microsoft Store tanımlayıcısını ve tanımlayıcı türünü belirtir. Şu anda yalnızca Paket Aile Adı (PFN) desteklenmektedir. pfn://<x.y.z>formunu kullanarak Evrensel Windows Platformu (UWP) uygulamasına başvurmak için PFN kullanın.

Uyarı

SoftwareID girdileri ve değerleriyle ilgili kısıtlamalar hakkında bilgi için bkz. SoftwareType.

Ayrıca Bkz.

Bileşen INF Dosyası Kullanarak

INF DDInstall.Software Bölümü

INF AddComponent Yönergesi

Evrensel Windows Platformu (UWP) uygulamasıyla sürücü eşleştirme

Donanım Destek Uygulaması (HSA): Sürücü Geliştiricileri için Adımlar