Aracılığıyla paylaş


Cihaz Yükleme İşlevlerini Kullanma

Bu bölümde cihaz yükleme işlevleri özetlenmektedir. Yükleme yazılımı, cihaz yükleme işlevlerini kullanarak aşağıdaki işlem türlerini gerçekleştirebilir:

  • Sürücüleri yükleme

  • DIF kodlarını işleme.

  • Cihaz bilgi kümelerini yönetme.

  • Sürücü listelerini yönetin.

  • Cihaz arabirimlerini yönetme.

  • Simgeleri ve diğer bitmap'leri yönetin.

Aşağıdaki tablolarda aşağıdaki işlev türlerinin özetleri sağlanır:

Sürücü Yükleme İşlevleri

Cihaz Bilgileri İşlevleri

Sürücü Bilgileri İşlevleri

Cihaz Yükleme İşleyicileri

Cihaz Yükleme Özelleştirme İşlevleri

Sınıf İşlevlerini Ayarlama

Bit Eşlem ve Simge İşlevleri

Cihaz Arabirimi İşlevleri

Cihaz Özelliği İşlevleri (Windows Vista ve Üzeri)

Kayıt Defteri İşlevleri

Diğer İşlevler

Sürücü Yükleme İşlevleri

DiInstallDevice

Sistemde bulunan bir PnP cihazına sürücü deposuna önceden yüklenmiş belirtilen bir sürücü paketini yükler. (Windows Vista ve Windows'un sonraki sürümleri)

DiUninstallDevice

Bir cihazı kaldırır ve cihaz düğümünü (devnode) sistemden kaldırır. (Windows'un Windows 7 ve sonraki sürümleri)

DiInstallDriver

Sürücü deposuna bir sürücü paketini önceden yükler ve ardından sürücü paketini sistemde bulunan eşleşen PnP cihazlarına yükler. (Windows Vista ve Windows'un sonraki sürümleri)

DiUninstallDriver

Sürücü paketini Sürücü Deposu'ndan kaldırır. (Windows 10 Sürüm 1703 ve sonraki Windows sürümleri)

Tak ve Çalıştır Cihazlar İçin Sürücüyü Güncelle

Sistemde bulunan eşleşen PnP cihazları için yüklenen sürücü paketini güncelleştirir.

DiRollbackDriver

Belirtilen bir cihazda yüklü olan sürücü paketini, cihaz için ayarlanan yedekleme sürücüsü paketine geri alır. (Windows Vista ve Windows'un sonraki sürümleri)

Cihaz Bilgileri İşlevleri

Uyarı

SetupApi, Windows'un tüm sürümlerinde desteklenmez. Mümkün olduğunda, CfgMgr32.dllaracılığıyla sağlananlar gibi alt katman API'lerini kullanmanız gerekir. İpuçları için bkz. SetupApi'den CfgMgr32'ye taşıma.

SetupDiCreateDeviceInfoList

Boş bir cihaz bilgi kümesi oluşturur. Bu küme bir sınıf GUID'i ile ilişkilendirilebilir.

SetupDiCreateDeviceInfoListEx

Boş bir cihaz bilgi kümesi oluşturur. Bu küme bir sınıf GUID'si ile ilişkilendirilebilir ve uzak bilgisayardaki cihazlar için olabilir.

SetupDiCreateDeviceInfo

Yeni bir cihaz bilgileri öğesi oluşturur ve bunu belirtilen cihaz bilgileri kümesine yeni bir üye olarak ekler.

SetupDiOpenDeviceInfo

Mevcut bir cihaz örneği hakkındaki bilgileri alır ve belirtilen cihaz bilgi kümesine ekler.

SetupDiEnumDeviceInfo

Bir cihaz bilgi kümesinin cihaz bilgileri öğesi için bağlam yapısı döndürür.

SetupDiGetDeviceInstanceId

Bir cihaz bilgisi öğesiyle ilişkili cihaz örneği kimliğini alır.

SetupDiGetDeviceInfoListClass

İlişkili bir sınıfı varsa cihaz bilgi kümesiyle ilişkilendirilmiş sınıf GUID'sini alır.

SetupDiGetDeviceInfoListDetail

Sınıf GUID'si, uzak bilgisayar tanıtıcısı ve uzak bilgisayar adı gibi bir cihaz bilgi kümesiyle ilişkili bilgileri alır.

SetupDiGetClassDevPropertySheets

Belirtilen cihaz bilgi öğesinin veya belirtilen cihaz bilgi kümesinin cihaz kurulum sınıfının özellik sayfalarına ait tanıtıcıları alır.

SetupDiGetClassDevs

Belirtilen sınıfın tüm cihazlarını içeren bir cihaz bilgi kümesi döndürür.

SetupDiGetClassDevsEx

Yerel veya uzak bir bilgisayardaki belirtilen sınıfın tüm cihazlarını içeren bir cihaz bilgi kümesi döndürür.

SetupDiSetSelectedDevice

Belirtilen cihaz bilgileri öğesini, bir cihaz bilgi kümesinin seçili durumdaki üyesi olacak şekilde ayarlar. Bu işlev genellikle bir yükleme sihirbazı tarafından kullanılır.

SetupDiGetSelectedDevice

Belirtilen cihaz bilgi kümesi için şu anda seçili olan cihazı alır.

SetupDiRegisterDeviceInfo

Yeni oluşturulan bir cihaz örneğini Tak Çalıştır yöneticisine kaydeder.

SetupDiDeleteDeviceInfo

Belirtilen cihaz bilgileri kümesinden bir üyeyi siler. Bu işlev gerçek cihazı silmez.

SetupDiDestroyDeviceInfoList

Bir cihaz bilgi kümesini yok eder ve ilişkili tüm belleği serbest bırakır.

Sürücü Bilgileri İşlevleri

SetupDiBuildDriverInfoList

Belirtilen bir cihaz örneğiyle veya cihaz bilgi kümesinin genel sınıf sürücü listesiyle ilişkili sürücülerin listesini oluşturur.

SetupDiEnumDriverInfo

Sürücü bilgileri listesinin üyelerini numaralandırır.

SetupDiGetDriverInfoDetail

Belirtilen sürücü bilgileri öğesi için ayrıntılı bilgileri alır.

SetupDiSetSelectedDriver

Bir sürücü listesinin belirtilen üyesini seçili durumdaki sürücü olarak ayarlar. Şu anda seçili sürücü olmaması için sürücü listesini sıfırlamak için de kullanılabilir.

SetupDiGetSelectedDriver

Yüklenecek sürücü olarak seçilen sürücü listesinin üyesini alır.

SetupDiCancelDriverInfoSearch

Şu anda farklı bir iş parçacığında devam eden sürücü listesi aramasını iptal eder.

SetupDiDestroyDriverInfoList

Sürücü bilgi listesini yok eder.

Cihaz Yükleme İşleyicileri

SetupDiCallClassInstaller

Belirtilen yükleme isteğiyle uygun sınıf yükleyicisini ve tüm kayıtlı ortak yükleyicileri çağırır.

SetupDiChangeState

DIF_PROPERTYCHANGE isteği için varsayılan işleyici. Yüklü bir cihazın durumunu değiştirmek için kullanılabilir.

SetupDiRegisterCoDeviceInstallers

Belirtilen cihaz için INF dosyasında listelenen cihaza özgü ortak yükleyicileri kaydeder. Bu işlev, DIF_REGISTER_COINSTALLERS için varsayılan işleyicidir.

SetupDiInstallDevice

DIF_INSTALLDEVICE isteği için varsayılan işleyici.

SetupDiInstallDriverFiles

DIF_INSTALLDEVICEFILES isteği için varsayılan işleyici.

SetupDiInstallDeviceInterfaces

DIF_INSTALLINTERFACES isteği için varsayılan işleyici. DDInstall içinde listelenen arabirimleri yükler. Cihaz INF dosyasının Arabirimler bölümü.

SetupDiMoveDuplicateDevice

Bu işlev eskidir ve Microsoft Windows'un herhangi bir sürümünde kullanılamaz.

SetupDiRemoveDevice

DIF_REMOVEDEVICE isteği için varsayılan işleyici.

SetupDiUnremoveDevice

DIF_UNREMOVE isteği için varsayılan işleyici.

SetupDiRegisterDeviceInfo

DIF_REGISTERDEVICE isteği için varsayılan işleyici.

SetupDiSelectDevice

DIF_SELECTDEVICE isteği için varsayılan işleyici.

SetupDiSelectBestCompatDrv

DIF_SELECTBESTCOMPATDRV isteği için varsayılan işleyici.

SetupDiSelectDevice

DIF_SELECTDEVICE isteği için varsayılan işleyici.

Cihaz Yükleme Özelleştirme İşlevleri

SetupDiGetClassInstallParams

Bir cihaz bilgi kümesi veya belirli bir cihaz bilgileri öğesi için sınıf yükleme parametrelerini alır.

SetupDiSetClassInstallParams

Bir cihaz bilgi kümesi veya belirli bir cihaz bilgileri öğesi için sınıf yükleme parametrelerini ayarlar veya temizler.

SetupDiGetDeviceInstallParams

Bir cihaz bilgi kümesi veya belirli bir cihaz bilgileri öğesi için cihaz yükleme parametrelerini alır.

SetupDiSetDeviceInstallParams

Cihaz bilgi kümesi veya belirli bir cihaz bilgileri öğesi için cihaz yükleme parametrelerini ayarlar.

SetupDiGetDriverInstallParams

Belirtilen sürücü için yükleme parametrelerini alır.

SetupDiSetDriverInstallParams

Belirtilen sürücü için yükleme parametrelerini ayarlar.

Sınıf İşlevlerini Ayarlama

SetupDiBuildClassInfoList

Sistemde yüklü olan her sınıfı içeren kurulum sınıfı GUID'lerinin listesini döndürür.

SetupDiBuildClassInfoListEx

Yerel sistemde veya uzak sistemde yüklü olan her sınıfı içeren kurulum sınıfı GUID'lerinin listesini döndürür.

SetupDiGetClassDescription

Belirtilen kurulum sınıfı GUID'i ile ilişkili sınıf açıklamasını alır.

SetupDiGetClassDescriptionEx

Yerel veya uzak bilgisayarda yüklü bir kurulum sınıfının açıklamasını alır.

SetupDiGetINFClass

Belirtilen cihaz INF dosyasının sınıfını alır.

SetupDiClassGuidsFromName

Belirtilen sınıf adıyla ilişkili GUID'leri alır. Bu liste, şu anda sistemde yüklü olan sınıflara göre oluşturulur.

SetupDiClassGuidsFromNameEx

Belirtilen sınıf adıyla ilişkili GUID'leri alır. Bu sonuçta elde edilen liste, yerel veya uzak bilgisayarda yüklü olan sınıfları içerir.

SetupDiClassNameFromGuid

Sınıf GUID'i ile ilişkili sınıf adını alır.

SetupDiClassNameFromGuidEx

Sınıf GUID'i ile ilişkili sınıf adını alır. sınıfı yerel veya uzak bir bilgisayara yüklenebilir.

SetupDiInstallClass

Belirtilen INF dosyasının ClassInstall32 bölümünü yükler.

SetupDiInstallClassEx

Bir sınıf yükleyicisi veya arabirim sınıfı yükler.

SetupDiOpenClassRegKey

Cihaz kurulum sınıfı kayıt defteri anahtarını veya sınıfın belirli bir alt anahtarını açar.

SetupDiOpenClassRegKeyEx

Cihaz kurulum sınıfı kayıt defteri anahtarını, cihaz arabirimi sınıf kayıt defteri anahtarını veya sınıfın belirli bir alt anahtarını açar. Bu işlev, belirtilen anahtarı yerel bilgisayarda veya uzak bir bilgisayarda açar.

Bit Eşlem ve Simge İşlevleri

SetupDiGetClassImageList

Yüklenen her sınıf için bit eşlemler içeren bir görüntü listesi oluşturur ve listeyi bir veri yapısında döndürür.

SetupDiGetClassImageListEx

Yerel veya uzak bilgisayarda yüklü her sınıf için bit eşlemlerin görüntü listesini oluşturur.

SetupDiGetClassImageIndex

Belirtilen sınıfın görüntü listesindeki dizini alır.

SetupDiGetClassBitmapIndex

Belirtilen sınıfa ait sağlanan mini simgenin dizinini alır.

SetupDiDrawMiniIcon

Belirtilen mini simgeyi istenen konuma çizer.

SetupDiLoadClassIcon

Belirtilen sınıf için hem büyük hem de mini simgeyi yükler.

SetupDiLoadDeviceIcon

Belirtilen cihaz için bir cihaz simgesi yükler. (Windows Vista ve Windows'un sonraki sürümleri)

SetupDiDestroyClassImageList

Bir sınıfa ait görüntü listesini yok eder.

Cihaz Arabirimi İşlevleri

Uyarı

SetupApi, Windows'un tüm sürümlerinde desteklenmez. Mümkün olduğunda, CfgMgr32.dllaracılığıyla sağlananlar gibi alt katman API'lerini kullanmanız gerekir. İpuçları için bkz. SetupApi'den CfgMgr32'ye taşıma.

SetupDiCreateDeviceInterface

Bir cihaz için cihaz işlevselliğini (cihaz arabirimi) kaydeder.

SetupDiOpenDeviceInterface

Mevcut bir cihaz arabirimi hakkındaki bilgileri alır ve belirtilen cihaz bilgi kümesine ekler.

SetupDiGetDeviceInterfaceAlias

Belirtilen cihaz arabiriminin diğer adını döndürür.

SetupDiGetClassDevs

Belirtilen sınıfın tüm cihazlarını içeren bir cihaz bilgi kümesi döndürür.

SetupDiGetClassDevsEx

Yerel veya uzak bir bilgisayardaki belirtilen sınıfın tüm cihazlarını içeren bir cihaz bilgi kümesi döndürür.

SetupDiEnumDeviceInterfaces

Bir cihaz bilgi kümesinin cihaz arabirim öğesi için bağlam yapısı döndürür. Her çağrı, bir cihaz arabirimi hakkında bilgi döndürür.

İşlev, bir veya daha fazla cihaz tarafından kullanıma sunulan çeşitli arabirimler hakkında bilgi edinmek için tekrar tekrar çağrılabilir.

SetupDiGetDeviceInterfaceDetail

Belirli bir cihaz arabirimi hakkındaki ayrıntıları döndürür.

SetupDiCreateDeviceInterfaceRegKey

Bir cihaz arabirimi örneği hakkındaki bilgileri depolamak için bir kayıt defteri alt anahtarı oluşturur ve anahtara bir tanıtıcı döndürür.

SetupDiOpenDeviceInterfaceRegKey

Bir cihaz arabirimi örneğine özgü bilgileri depolamak için uygulamalar ve sürücüler tarafından kullanılan kayıt defteri alt anahtarını açar ve anahtara bir tanıtıcı döndürür.

SetupDiDeleteDeviceInterfaceRegKey

Bir cihaz arabirimi örneğine özgü bilgileri depolamak için uygulamalar ve sürücüler tarafından kullanılan kayıt defteri alt anahtarını siler.

SetupDiInstallDeviceInterfaces

DIF_INSTALLINTERFACES isteği için varsayılan işleyicidir. DDInstall içinde listelenen arabirimleri yükler. Cihaz INF dosyasının Arabirimler bölümü.

SetupDiRemoveDeviceInterface

Kayıtlı bir cihaz arabirimini sistemden kaldırır.

SetupDiDeleteDeviceInterfaceData

Cihaz bilgi kümesinden bir cihaz arabirimini siler.

SetupDiSetDeviceInterfaceDefault

Belirtilen cihaz arabirimini bir cihaz sınıfı için varsayılan arabirim olarak ayarlar.

SetupDiInstallClassEx

Bir sınıf yükleyicisi veya arabirim sınıfı yükler.

SetupDiOpenClassRegKeyEx

Cihaz kurulum sınıfı kayıt defteri anahtarını, cihaz arabirimi sınıf kayıt defteri anahtarını veya sınıfın belirli bir alt anahtarını açar. Bu işlev, belirtilen anahtarı yerel bilgisayarda veya uzak bir bilgisayarda açar.

Cihaz Özelliği İşlevleri (Windows Vista ve Üzeri)

Uyarı

SetupApi, Windows'un tüm sürümlerinde desteklenmez. Mümkün olduğunda, CfgMgr32.dllaracılığıyla sağlananlar gibi alt katman API'lerini kullanmanız gerekir. İpuçları için bkz. SetupApi'den CfgMgr32'ye taşıma.

SetupDiGetClassProperty

Cihaz kurulum sınıfı veya cihaz arabirimi sınıfı için ayarlanmış bir cihaz özelliğini alır.

SetupDiGetClassPropertyEx

Yerel veya uzak bilgisayardaki bir cihaz kurulum sınıfı veya cihaz arabirimi sınıfı için sınıf özelliğini alır.

SetupDiGetClassPropertyKeys

Cihaz kurulum sınıfı veya cihaz arabirimi sınıfı için ayarlanan cihaz özelliklerini temsil eden cihaz özellik anahtarlarının dizisini alır.

SetupDiGetClassPropertyKeysEx

Yerel veya uzak bir bilgisayardaki bir cihaz kurulum sınıfı veya cihaz arabirim sınıfı için ayarlanan cihaz özelliklerini temsil eden cihaz özellik anahtarları dizisini alır.

SetupDiGetDeviceInterfaceProperty

Cihaz arabirimi için ayarlanmış bir cihaz özelliğini alır.

SetupDiGetDeviceInterfacePropertyKeys

Bir cihaz arabirimi için ayarlanan cihaz özelliklerini temsil eden bir cihaz özellik anahtarları dizisi alır.

SetupDiGetDeviceProperty

Bir cihaz örneği özelliğini geri alır.

SetupDiGetDevicePropertyKeys

Bir cihaz örneği için ayarlanan cihaz özelliklerini temsil eden cihaz özellik anahtarları dizisini alır.

SetupDiSetClassProperty

Cihaz kurulum sınıfı veya cihaz arabirimi sınıfı için sınıf özelliğini ayarlar.

SetupDiSetClassPropertyEx

Yerel veya uzak bilgisayardaki bir cihaz kurulum sınıfı veya cihaz arabirimi sınıfı için cihaz özelliğini ayarlar.

SetupDiSetDeviceInterfaceProperty

Cihaz arabiriminin cihaz özelliğini ayarlar.

SetupDiSetDeviceProperty

Cihaz örneği özelliğini ayarlar.

Kayıt Defteri İşlevleri

Uyarı

SetupApi, Windows'un tüm sürümlerinde desteklenmez. Mümkün olduğunda, CfgMgr32.dllaracılığıyla sağlananlar gibi alt katman API'lerini kullanmanız gerekir. İpuçları için bkz. SetupApi'den CfgMgr32'ye taşıma.

SetupDiCreateDevRegKey

Cihaza özgü yapılandırma bilgileri için bir kayıt defteri depolama anahtarı oluşturur ve anahtara bir kulp döndürür.

SetupDiOpenDevRegKey

Cihaza özgü yapılandırma bilgileri için bir kayıt defteri anahtarı açar ve bu anahtara bir tanıtıcı döndürür.

SetupDiDeleteDevRegKey

Bir cihaz bilgileri öğesiyle ilişkili, kullanıcı tarafından erişilebilen belirtilen kayıt defteri anahtarlarını siler.

SetupDiOpenClassRegKey

Kurulum sınıfı kayıt defteri anahtarını veya sınıfın belirli bir alt anahtarını açar.

SetupDiOpenClassRegKeyEx

Cihaz kurulum sınıfı kayıt defteri anahtarını, cihaz arabirimi sınıf kayıt defteri anahtarını veya sınıfın belirli bir alt anahtarını açar.

Bu işlev, belirtilen anahtarı yerel bilgisayarda veya uzak bir bilgisayarda açar.

SetupDiCreateDeviceInterfaceRegKey

Cihaz arabirimi örneği hakkındaki bilgileri depolamak için kalıcı olmayan bir kayıt defteri alt anahtarı oluşturur ve anahtara bir tanıtıcı döndürür.

SetupDiOpenDeviceInterfaceRegKey

Bir cihaz arabirimi örneğine özgü bilgileri depolamak için uygulamalar ve sürücüler tarafından kullanılan kayıt defteri alt anahtarını açar ve anahtara bir tanıtıcı döndürür.

SetupDiDeleteDeviceInterfaceRegKey

Bir cihaz arabirimi örneğine özgü bilgileri depolamak için uygulamalar ve sürücüler tarafından kullanılan kayıt defteri alt anahtarını siler.

SetupDiSetDeviceRegistryProperty

Belirtilen Tak ve Kullan cihaz özelliğini ayarlar.

SetupDiGetDeviceRegistryProperty

Belirtilen Tak Çalıştır cihaz özelliğini alır.

SetupDiGetClassRegistryProperty

Belirtilen cihaz sınıfı özelliğini kayıt defterinden alır.

SetupDiSetClassRegistryProperty

Kayıt defterinde belirtilen cihaz sınıfı özelliğini ayarlar.

Diğer İşlevler

SetupDiGetActualModelsSection fonksiyonu

Cihaz INF dosyasından cihaz yüklerken kullanılacak uygun dekore edilmiş INF Modelleri bölümünü alır.

SetupDiGetActualSectionToInstall

Cihaz INF dosyasından cihaz yüklerken kullanılacak uygun DDInstall bölümünü alır.

SetupDiGetActualSectionToInstallEx

Belirtilen işletim sistemi ve işlemci mimarisi için bir cihaz yükleyen INF DDInstall bölümünün adını alır.

SetupDiGetHwProfileFriendlyName

Donanım profili kimliğiyle ilişkili dostça adı alır.

SetupDiGetHwProfileFriendlyNameEx

Yerel veya uzak bilgisayardaki donanım profili kimliğiyle ilişkilendirilmiş kullanıcı dostu adı alır.

SetupDiGetHwProfileList

Şu anda tanımlanmış olan tüm donanım profili kimliklerinin listesini alır.

SetupDiGetHwProfileListEx

Yerel veya uzak bilgisayardaki şu anda tanımlanmış olan tüm donanım profili kimliklerinin listesini alır.

SetupDiRestartDevices

Belirtilen bir cihazı yeniden başlatır veya gerekirse, aynı işlev tarafından çalıştırılan tüm cihazları başlatır ve sürücüleri belirtilen cihazla filtreler.