Použití funkcí instalace zařízení

Tato část shrnuje funkce instalace zařízení. Pomocí instalačních funkcí zařízení může instalační software provádět následující typy operací:

  • Instalace ovladačů

  • Zpracovat kódy DIF

  • Spravovat sady informací o zařízení

  • Spravovat seznamy ovladačů

  • Spravujte rozhraní zařízení.

  • Spravovat ikony a další rastrové obrázky.

Následující tabulky obsahují souhrny následujících typů funkcí:

Funkce instalace ovladačů

Informace o zařízení

Informační funkce ovladače

Obslužné rutiny instalace zařízení

Funkce přizpůsobení instalace zařízení

Funkce třídy Setup

Funkce bitmap a ikon

Funkce rozhraní zařízení

Funkce vlastností zařízení (Windows Vista a novější)

Funkce registru

Další funkce

Funkce instalace ovladačů

DiInstallDevice

Nainstaluje zadaný balíček ovladače, který je předinstalovaný v úložišti ovladačů na zařízení PnP, které je přítomné v systému. (Windows Vista a novější verze Windows)

DiUninstallDevice

Odinstaluje zařízení a odebere jeho uzel zařízení (devnode) ze systému. (Windows 7 a novější verze Windows)

DiInstallDriver

Předinstaluje balíček ovladače v úložišti ovladačů a potom nainstaluje balíček ovladače pro odpovídající zařízení PnP, která jsou v systému. (Windows Vista a novější verze Windows)

DiUninstallDriver

Odebere balíček ovladače z úložiště ovladačů. (Windows 10 verze 1703 a novější verze Windows)

UpdateDriverForPlugAndPlayDevices

Aktualizuje balíček ovladače, který je nainstalovaný pro odpovídající zařízení PnP, která jsou v systému.

DiRollbackDriver

Vrátí balíček ovladačů nainstalovaný na zadaném zařízení zpět na záložní sadu balíčků ovladačů nastavenou pro dané zařízení. (Windows Vista a novější verze Windows)

Funkce informací o zařízení

Note

SetupApi není podporován ve všech edicích Windows. Pokud je to možné, měli byste použít rozhraní API nižší vrstvy, například rozhraní API, která jsou k dispozici prostřednictvím CfgMgr32.dll. Tipy najdete v tématu Portování z SetupApi do CfgMgr32 .

SetupDiCreateDeviceInfoList

Vytvoří prázdnou sadu informací o zařízení. Tuto sadu lze přidružit ke třídě GUID.

SetupDiCreateDeviceInfoListEx

Vytvoří prázdnou sadu informací o zařízení. Tuto sadu lze přidružit k identifikátoru GUID třídy a může být určená pro zařízení ve vzdáleném počítači.

SetupDiCreateDeviceInfo

Vytvoří nový prvek informací o zařízení a přidá ho jako nového člena do zadané sady informací o zařízení.

SetupDiOpenDeviceInfo

Načte informace o existující instanci zařízení a přidá je do zadané sady informací o zařízení.

SetupDiEnumDeviceInfo

Vrátí kontextovou strukturu pro prvek informací o zařízení ze sady informací o zařízení.

SetupDiGetDeviceInstanceId

Načte ID instance zařízení přidružené k prvku informací zařízení.

SetupDiGetDeviceInfoListClass

Načte identifikátor GUID třídy přidružený k sadě informací o zařízení, pokud má přidruženou třídu.

SetupDiGetDeviceInfoListDetail

Načte informace přidružené k sadě informací o zařízení, včetně identifikátoru GUID třídy, popisovače vzdáleného počítače a názvu vzdáleného počítače.

SetupDiGetClassDevPropertySheets

Načte popisovače listů vlastností zadaného prvku informací o zařízení nebo třídy nastavení zařízení zadané sady informací o zařízení.

SetupDiGetClassDevs

Vrátí sadu informací o zařízeních, která obsahuje všechna zařízení zadané třídy.

SetupDiGetClassDevsEx

Vrátí sadu informací o zařízení, která obsahuje všechna zařízení zadané třídy na místním nebo vzdáleném počítači.

SetupDiSetSelectedDevice

Nastaví zadaný prvek informací o zařízení tak, aby byl aktuálně vybraným členem sady informací o zařízení. Tuto funkci obvykle používá průvodce instalací.

SetupDiGetSelectedDevice

Načte aktuálně vybrané zařízení pro zadanou sadu informací o zařízení.

SetupDiRegisterDeviceInfo

Zaregistruje nově vytvořenou instanci zařízení ve správci technologie Plug and Play.

SetupDiDeleteDeviceInfo

Odstraní položku ze zadané sady informací o zařízení. Tato funkce neodstraní fyzické zařízení.

SetupDiDestroyDeviceInfoList

Zničí sadu informací o zařízení a uvolní veškerou přidruženou paměť.

Funkce informací o ovladače

SetupDiBuildDriverInfoList

Vytvoří seznam ovladačů přidružených k zadané instanci zařízení nebo ke globálnímu seznamu ovladačů tříd sady informací o zařízení.

SetupDiEnumDriverInfo

Vyjmenuje členy seznamu informací o ovladači.

SetupDiGetDriverInfoDetail

Načte podrobné informace o zadaném prvku s informacemi o ovladači.

SetupDiSetSelectedDriver

Nastaví zadaný člen seznamu ovladačů jako aktuálně vybraný ovladač. Dá se také použít k resetování seznamu ovladačů, aby nebyl aktuálně vybraný žádný ovladač.

SetupDiGetSelectedDriver

Načte položku seznamu ovladačů, která byla vybrána jako ovladač k instalaci.

SetupDiCancelDriverInfoSearch

Zruší vyhledávání v seznamu ovladačů, které právě probíhá v jiném vlákně.

SetupDiDestroyDriverInfoList

Zničí seznam informací o řidiči.

Obslužné programy instalace zařízení

SetupDiCallClassInstaller

Zavolá příslušný instalační program třídy a všechny registrované společné instalační programy se zadaným požadavkem na instalaci.

SetupDiChangeState

Výchozí obslužná rutina požadavku DIF_PROPERTYCHANGE. Dá se použít ke změně stavu nainstalovaného zařízení.

SetupDiRegisterCoDeviceInstallers

Zaregistruje spolumoduly instalace specifické pro zařízení uvedené v souboru INF pro zadané zařízení. Tato funkce je výchozí obslužnou rutinou pro DIF_REGISTER_COINSTALLERS.

SetupDiInstallDevice

Výchozí obslužná rutina požadavku DIF_INSTALLDEVICE.

SetupDiInstallDriverFiles

Výchozí obslužná rutina požadavku DIF_INSTALLDEVICEFILES.

SetupDiInstallDeviceInterfaces

Výchozí obslužná rutina požadavku DIF_INSTALLINTERFACES. Nainstaluje rozhraní uvedená v oddílu DDInstall.Interfaces v INF souboru zařízení.

SetupDiMoveDuplicateDevice

Tato funkce je zastaralá a nelze ji použít v žádné verzi Microsoft Windows.

SetupDiRemoveDevice

Výchozí obsluha požadavku DIF_REMOVEDEVICE.

SetupDiUnremoveDevice

Výchozí obslužná rutina požadavku DIF_UNREMOVE.

SetupDiRegisterDeviceInfo

Výchozí obslužná rutina požadavku DIF_REGISTERDEVICE.

SetupDiSelectDevice

Výchozí obslužná rutina požadavku DIF_SELECTDEVICE.

SetupDiSelectBestCompatDrv

Výchozí obslužná procedura pro požadavek DIF_SELECTBESTCOMPATDRV.

SetupDiSelectDevice

Výchozí obslužná rutina požadavku DIF_SELECTDEVICE.

Funkce přizpůsobení instalace zařízení

SetupDiGetClassInstallParams

Získá parametry instalace třídy pro sadu informací o zařízení nebo konkrétní prvek informací o zařízení.

SetupDiSetClassInstallParams

Nastaví nebo vymaže parametry instalace třídy pro sadu informací o zařízení nebo konkrétní prvek informací o zařízení.

SetupDiGetDeviceInstallParams

Získá parametry instalace zařízení pro sadu informací o zařízení nebo konkrétní prvek informací o zařízení.

SetupDiSetDeviceInstallParams

Nastaví parametry instalace zařízení pro sadu informací o zařízení nebo pro konkrétní prvek informací o zařízení.

SetupDiGetDriverInstallParams

Načte parametry instalace pro zadaný ovladač.

SetupDiSetDriverInstallParams

Nastaví parametry instalace pro zadaný ovladač.

Funkce třídy Setup

SetupDiBuildClassInfoList

Vrátí seznam identifikátorů GUID tříd nastavení, který obsahuje všechny třídy nainstalované v systému.

SetupDiBuildClassInfoListEx

Vrátí seznam identifikátorů GUID tříd nastavení, který zahrnuje všechny třídy nainstalované v místním systému nebo ve vzdáleném systému.

SetupDiGetClassDescription

Načte popis třídy přidružený s GUID zadané třídy nastavení.

SetupDiGetClassDescriptionEx

Načte popis třídy instalace nainstalované na místním nebo vzdáleném počítači.

SetupDiGetINFClass

Načte třídu zadaného souboru INF zařízení.

SetupDiClassGuidsFromName

Načte identifikátory GUID přidružené k zadanému názvu třídy. Tento seznam je založený na tom, jaké třídy jsou aktuálně nainstalovány v systému.

SetupDiClassGuidsFromNameEx

Načte identifikátory GUID přidružené k zadanému názvu třídy. Tento výsledný seznam obsahuje třídy, které jsou aktuálně nainstalovány v místním nebo vzdáleném počítači.

SetupDiClassNameFromGuid

Načte název třídy přidružený k identifikátoru GUID třídy.

SetupDiClassNameFromGuidEx

Načte název třídy přidružený k identifikátoru GUID třídy. Třídu lze nainstalovat na místní nebo vzdálený počítač.

SetupDiInstallClass

Nainstaluje sekci ClassInstall32 zadaného souboru INF.

SetupDiInstallClassEx

Nainstaluje instalační modul třídy nebo třídu interface.

SetupDiOpenClassRegKey

Otevře klíč registru třídy instalace zařízení nebo konkrétní podklíč této třídy.

SetupDiOpenClassRegKeyEx

Otevře klíč registru třídy nastavení zařízení, klíč registru třídy rozhraní zařízení nebo konkrétní podklíč třídy. Tato funkce otevře zadaný klíč na místním počítači nebo ve vzdáleném počítači.

Funkce bitmap a ikon

SetupDiGetClassImageList

Vytvoří seznam obrázků, který obsahuje rastrové obrázky pro každou nainstalovanou třídu a vrátí seznam v datové struktuře.

SetupDiGetClassImageListEx

Vytvoří seznam bitových map pro každou třídu nainstalovanou na místním nebo vzdáleném počítači.

SetupDiGetClassImageIndex

Vrátí index v seznamu obrázků třídy zadané třídy.

SetupDiGetClassBitmapIndex

Načte index miniikony přiřazené zadané třídě.

SetupDiDrawMiniIcon

Nakreslí zadanou mini ikonu v požadovaném umístění.

SetupDiLoadClassIcon

Načte velkou i mini ikonu pro zadanou třídu.

SetupDiLoadDeviceIcon

Načte ikonu zařízení pro zadané zařízení. (Windows Vista a novější verze Windows)

SetupDiDestroyClassImageList

Zničí seznam obrázků třídy.

Funkce rozhraní zařízení

Note

SetupApi není podporován ve všech edicích Windows. Pokud je to možné, měli byste použít rozhraní API nižší vrstvy, například rozhraní API, která jsou k dispozici prostřednictvím CfgMgr32.dll. Tipy najdete v tématu Portování z SetupApi do CfgMgr32 .

SetupDiCreateDeviceInterface

Zaregistruje funkcionalitu zařízení (rozhraní zařízení) pro zařízení.

SetupDiOpenDeviceInterface

Načte informace o existujícím rozhraní zařízení a přidá je do zadané sady informací o zařízení.

SetupDiGetDeviceInterfaceAlias

Vrátí alias pro zadané rozhraní zařízení.

SetupDiGetClassDevs

Vrátí sadu informací o zařízeních, která obsahuje všechna zařízení zadané třídy.

SetupDiGetClassDevsEx

Vrátí sadu informací o zařízení, která obsahuje všechna zařízení zadané třídy v místním nebo vzdáleném počítači.

SetupDiEnumDeviceInterfaces

Vrátí kontextovou strukturu pro prvek rozhraní zařízení ze sady informací o zařízení. Každé volání vrací informace o jednom rozhraní zařízení.

Funkci lze volat opakovaně za účelem získání informací o několika rozhraních zpřístupněných jedním nebo více zařízeními.

SetupDiGetDeviceInterfaceDetail

Vrátí podrobnosti o konkrétním rozhraní zařízení.

SetupDiCreateDeviceInterfaceRegKey

Vytvoří podklíč registru pro ukládání informací o instanci rozhraní zařízení a vrátí popisovač klíče.

SetupDiOpenDeviceInterfaceRegKey

Otevře podklíč registru používaný aplikacemi a ovladači k ukládání informací specifických pro instanci rozhraní zařízení a vrátí popisovač klíče.

SetupDiDeleteDeviceInterfaceRegKey

Odstraní podklíč registru používaný aplikacemi a ovladači k ukládání informací specifických pro instanci rozhraní zařízení.

SetupDiInstallDeviceInterfaces

Je výchozí obslužná rutina požadavku DIF_INSTALLINTERFACES. Nainstaluje rozhraní uvedená v oddílu DDInstall.Interfaces souboru INF zařízení.

SetupDiRemoveDeviceInterface

Odebere zaregistrované rozhraní zařízení ze systému.

SetupDiDeleteDeviceInterfaceData

Odstraní rozhraní zařízení ze sady informací o zařízení.

SetupDiSetDeviceInterfaceDefault

Nastaví zadané rozhraní zařízení jako výchozí rozhraní pro třídu zařízení.

SetupDiInstallClassEx

Nainstaluje instalační modul třídy nebo třídu rozhraní.

SetupDiOpenClassRegKeyEx

Otevře klíč registru třídy nastavení zařízení , klíč registru třídy rozhraní zařízení nebo konkrétní podklíč třídy. Tato funkce otevře zadaný klíč na místním počítači nebo ve vzdáleném počítači.

Funkce vlastností zařízení (Windows Vista a novější)

Note

SetupApi není podporován ve všech edicích Windows. Pokud je to možné, měli byste použít rozhraní API nižší vrstvy, například rozhraní API, která jsou k dispozici prostřednictvím CfgMgr32.dll. Tipy najdete v tématu Portování z SetupApi do CfgMgr32 .

SetupDiGetClassProperty

Načte vlastnost zařízení nastavenou pro třídu nastavení zařízení nebo třídu rozhraní zařízení.

SetupDiGetClassPropertyEx

Načte vlastnost třídy nastavení zařízení nebo třídy rozhraní zařízení v místním nebo vzdáleném počítači.

SetupDiGetClassPropertyKeys

Načte pole klíčů vlastností zařízení, které představují vlastnosti zařízení nastavené pro třídu nastavení zařízení nebo třídu rozhraní zařízení.

SetupDiGetClassPropertyKeysEx

Načte pole klíčů vlastností zařízení, které představují vlastnosti zařízení nastavené pro třídu nastavení zařízení nebo třídu rozhraní zařízení v místním nebo vzdáleném počítači.

SetupDiGetDeviceInterfaceProperty

Načte vlastnost zařízení nastavenou pro rozhraní zařízení.

SetupDiGetDeviceInterfacePropertyKeys

Načte pole klíčů vlastností zařízení, které představují vlastnosti zařízení nastavené pro dané rozhraní zařízení.

SetupDiGetDeviceProperty

Načte vlastnost instance zařízení.

SetupDiGetDevicePropertyKeys

Načte pole klíčů vlastností zařízení, které představují vlastnosti zařízení nastavené pro instanci zařízení.

SetupDiSetClassProperty

Nastaví vlastnost pro třídu nastavení zařízení nebo třídu rozhraní zařízení.

SetupDiSetClassPropertyEx

Nastaví vlastnost zařízení pro třídu nastavení zařízení nebo třídu rozhraní zařízení v místním nebo vzdáleném počítači.

SetupDiSetDeviceInterfaceProperty

Nastaví vlastnost zařízení pro rozhraní zařízení.

SetupDiSetDeviceProperty

Nastaví vlastnost instance zařízení.

Funkce registru

Note

SetupApi není podporován ve všech edicích Windows. Pokud je to možné, měli byste použít rozhraní API nižší vrstvy, například rozhraní API, která jsou k dispozici prostřednictvím CfgMgr32.dll. Tipy najdete v tématu Portování z SetupApi do CfgMgr32 .

SetupDiCreateDevRegKey

Vytvoří klíč úložiště registru pro informace o konfiguraci specifické pro zařízení a vrátí popisovač klíče.

SetupDiOpenDevRegKey

Otevře klíč úložiště registru pro informace o konfiguraci specifické pro zařízení a vrátí popisovač klíče.

SetupDiDeleteDevRegKey

Odstraní zadané uživateli přístupné klíče registru přidružené k prvku informací o zařízení.

SetupDiOpenClassRegKey

Otevře klíč registru třídy instalace nebo konkrétní podklíč třídy.

SetupDiOpenClassRegKeyEx

Otevře klíč registru třídy nastavení zařízení, klíč registru třídy rozhraní zařízení nebo konkrétní podklíč třídy.

Tato funkce otevře zadaný klíč na místním počítači nebo na vzdáleném počítači.

SetupDiCreateDeviceInterfaceRegKey

Vytvoří netěkavý podklíč registru pro ukládání informací o instanci rozhraní zařízení a vrátí popisovač ke klíči.

SetupDiOpenDeviceInterfaceRegKey

Otevře podklíč registru používaný aplikacemi a ovladači k ukládání informací specifických pro instanci rozhraní zařízení a vrátí popisovač klíče.

SetupDiDeleteDeviceInterfaceRegKey

Odstraní podklíč registru používaný aplikacemi a ovladači k ukládání informací specifických pro instanci rozhraní zařízení.

SetupDiSetDeviceRegistryProperty

Nastaví zadanou vlastnost technologie Plug and Play zařízení.

SetupDiGetDeviceRegistryProperty

Načte zadanou vlastnost technologie Plug and Play zařízení.

SetupDiGetClassRegistryProperty

Načte zadanou vlastnost třídy zařízení z registru.

SetupDiSetClassRegistryProperty

Nastaví zadanou vlastnost třídy zařízení v registru.

Další funkce

SetupDiGetActualModelsSection

Načte odpovídající oddíl modelů INF, který se použije při instalaci zařízení ze souboru INF zařízení.

SetupDiGetActualSectionToInstall

Načte odpovídající sekci DDInstall, která se použije při instalaci zařízení ze souboru INF zařízení.

SetupDiGetActualSectionToInstallEx

Načte název oddílu INF DDInstall , který nainstaluje zařízení pro zadaný operační systém a architekturu procesoru.

SetupDiGetHwProfileFriendlyName

Načte popisný název přidružený k ID hardwarového profilu.

SetupDiGetHwProfileFriendlyNameEx

Načte popisný název přidružený k ID hardwarového profilu na místním nebo vzdáleném počítači.

SetupDiGetHwProfileList

Načte seznam všech aktuálně definovaných ID hardwarových profilů.

SetupDiGetHwProfileListEx

Načte seznam všech aktuálně definovaných ID hardwarových profilů na místním nebo vzdáleném počítači.

SetupDiRestartDevices

Restartuje zadané zařízení nebo v případě potřeby spustí všechna zařízení obsluhovaná stejnými funkčními a filtračními ovladači jako zadané zařízení.