Udostępnij przez


Korzystanie z funkcji instalacji urządzeń

W tej sekcji podsumowano funkcje instalacji urządzenia. Za pomocą funkcji instalacji urządzenia oprogramowanie instalacyjne może wykonywać następujące typy operacji:

  • Instalowanie sterowników

  • Obsługa kodów DIF.

  • Zarządzanie zestawami informacji o urządzeniu.

  • Zarządzanie listami sterowników.

  • Zarządzanie interfejsami urządzeń.

  • Zarządzaj ikonami i innymi mapami bitowymi.

W poniższych tabelach przedstawiono podsumowanie następujących typów funkcji:

Funkcje instalacji sterowników

Funkcje informacji o urządzeniu

Funkcje informacji o sterowniku

Programy obsługi instalacji urządzeń

Funkcje dostosowywania instalacji urządzenia

Ustawienia funkcji klas

Funkcje mapy bitowej i ikony

Funkcje interfejsu urządzenia

Funkcje właściwości urządzenia (Windows Vista i nowsze)

Funkcje Rejestru

Inne funkcje

Funkcje instalacji sterowników

DiInstallDevice

Instaluje określony pakiet sterowników, który jest wstępnie zainstalowany w magazynie sterowników na urządzeniu PnP, które znajduje się w systemie. (Windows Vista i nowsze wersje systemu Windows)

DiUninstallDevice

Odinstalowuje urządzenie i usuwa węzeł urządzenia (devnode) z systemu. (Windows 7 i nowsze wersje systemu Windows)

DiInstallDriver

Wstępnie instaluje pakiet sterowników w magazynie sterowników, a następnie instaluje pakiet sterowników na pasujących urządzeniach PnP, które znajdują się w systemie. (Windows Vista i nowsze wersje systemu Windows)

DiUninstallDriver

Usuwa pakiet sterowników z magazynu sterowników. (Windows 10 w wersji 1703 i nowszych wersjach systemu Windows)

UpdateDriverForPlugAndPlayDevices

Aktualizuje pakiet sterowników zainstalowany dla pasujących urządzeń PnP, które znajdują się w systemie.

DiRollbackDriver

Przywraca pakiet sterowników zainstalowany na określonym urządzeniu do pakietu sterownika kopii zapasowej ustawionego dla urządzenia. (Windows Vista i nowsze wersje systemu Windows)

Funkcje informacji o urządzeniu

Uwaga

InstalatorApi nie jest obsługiwany we wszystkich wersjach systemu Windows. Jeśli to możliwe, należy użyć interfejsów API niższej warstwy, takich jak te dostępne za pośrednictwem CfgMgr32.dll. Aby uzyskać porady, zobacz Przenoszenie z setupApi do CfgMgr32 .

SetupDiCreateDeviceInfoList

Tworzy pusty zestaw informacji o urządzeniu. Zestaw ten może być powiązany z identyfikatorem GUID klasy.

SetupDiCreateDeviceInfoListEx

Tworzy pusty zestaw informacji o urządzeniu. Ten zestaw może być skojarzony z identyfikatorem GUID klasy i może być przeznaczony dla urządzeń na komputerze zdalnym.

SetupDiCreateDeviceInfo

Tworzy nowy element informacji o urządzeniu i dodaje go jako nowy element członkowski do określonego zestawu informacji o urządzeniu.

SetupDiOpenDeviceInfo

Pobiera informacje o istniejącym wystąpieniu urządzenia i dodaje je do określonego zestawu informacji o urządzeniu.

SetupDiEnumDeviceInfo

Zwraca strukturę kontekstową elementu informacji o urządzeniu zestawu informacji o urządzeniu.

SetupDiGetDeviceInstanceId

Pobiera identyfikator wystąpienia urządzenia skojarzony z elementem informacji o urządzeniu.

SetupDiGetDeviceInfoListClass

Pobiera identyfikator GUID klasy skojarzony z zestawem informacji o urządzeniu, jeśli ma skojarzoną klasę.

SetupDiGetDeviceInfoListDetail

Pobiera informacje skojarzone z zestawem informacji o urządzeniu, w tym identyfikator GUID klasy, uchwyt komputera zdalnego i nazwę komputera zdalnego.

SetupDiGetClassDevPropertySheets

Pobiera uchwyty do arkuszy właściwości określonego elementu informacji o urządzeniu lub klasy konfiguracji urządzenia określonego zestawu informacji o urządzeniu.

SetupDiGetClassDevs

Zwraca zestaw informacji o urządzeniu zawierający wszystkie urządzenia określonej klasy.

SetupDiGetClassDevsEx

Zwraca zestaw informacji o urządzeniu zawierający wszystkie urządzenia określonej klasy na komputerze lokalnym lub zdalnym.

SetupDiSetSelectedDevice

Ustawia określony element informacji o urządzeniu, który ma być aktualnie wybranym elementem członkowskim zestawu informacji o urządzeniu. Ta funkcja jest zwykle używana przez kreatora instalacji.

SetupDiGetSelectedDevice

Pobiera aktualnie wybrane urządzenie dla określonego zestawu informacji o urządzeniu.

SetupDiRegisterDeviceInfo

Rejestruje nowo utworzone wystąpienie urządzenia w menedżerze Plug and Play.

SetupDiDeleteDeviceInfo

Usuwa członka z określonego zestawu informacji o urządzeniu. Ta funkcja nie usuwa rzeczywistego urządzenia.

SetupDiDestroyDeviceInfoList

Niszczy zestaw informacji o urządzeniu i zwalnia całą skojarzoną pamięć.

Funkcje informacji o sterowniku

SetupDiBuildDriverInfoList

Tworzy listę sterowników skojarzonych z określonym wystąpieniem urządzenia lub z globalną listą sterowników klas zestawu informacji o urządzeniu.

SetupDiEnumDriverInfo

Wylicza członków listy informacji o sterowniku.

SetupDiGetDriverInfoDetail

Pobiera szczegółowe informacje dotyczące określonego elementu informacji o sterowniku.

SetupDiSetSelectedDriver

Ustawia określony element listy sterowników jako aktualnie wybrany sterownik. Można go również użyć do zresetowania listy sterowników, aby nie było aktualnie wybranego sterownika.

SetupDiGetSelectedDriver

Pobiera element z listy sterowników, który został wybrany jako sterownik do zainstalowania.

SetupDiCancelDriverInfoSearch

Anuluje wyszukiwanie listy sterowników, które jest obecnie w toku w innym wątku.

SetupDiDestroyDriverInfoList

Niszczy listę informacji o sterownikach.

Programy obsługi instalacji urządzeń

SetupDiCallClassInstaller

Wywołuje odpowiedni instalator klasy i wszystkie zarejestrowane współinstalacje z określonym żądaniem instalacji.

SetupDiChangeState

Domyślna procedura obsługi żądania DIF_PROPERTYCHANGE. Może służyć do zmiany stanu zainstalowanego urządzenia.

SetupDiRegisterCoDeviceInstallers

Rejestruje współinstalatory specyficzne dla urządzenia wymienione w pliku INF dla określonego urządzenia. Ta funkcja jest domyślną procedurą obsługi DIF_REGISTER_COINSTALLERS.

SetupDiInstallDevice

Domyślna procedura obsługi żądania DIF_INSTALLDEVICE.

SetupDiInstallDriverFiles

Domyślna procedura obsługi żądania DIF_INSTALLDEVICEFILES.

SetupDiInstallDeviceInterfaces

Domyślna procedura obsługi żądania DIF_INSTALLINTERFACES. Instaluje interfejsy wymienione w sekcji DDInstall.Interfejsy pliku INF urządzenia.

SetupDiMoveDuplicateDevice

Ta funkcja jest przestarzała i nie może być używana w żadnej wersji systemu Microsoft Windows.

SetupDiRemoveDevice

Domyślna procedura obsługi żądania DIF_REMOVEDEVICE.

SetupDiUnremoveDevice

Domyślna procedura obsługi żądania DIF_UNREMOVE.

SetupDiRegisterDeviceInfo

Domyślna procedura obsługi żądania DIF_REGISTERDEVICE.

SetupDiSelectDevice

Domyślna procedura obsługi żądania DIF_SELECTDEVICE.

SetupDiSelectBestCompatDrv

Domyślna procedura obsługi żądania DIF_SELECTBESTCOMPATDRV.

SetupDiSelectDevice

Domyślna procedura obsługi żądania DIF_SELECTDEVICE.

Funkcje dostosowywania instalacji urządzenia

SetupDiGetClassInstallParams

Pobiera parametry instalacji klasy dla zestawu informacji o urządzeniu lub określonego elementu informacji o urządzeniu.

SetupDiSetClassInstallParams

Ustawia lub czyści parametry instalacji klasy dla zestawu informacji o urządzeniu lub określonego elementu informacji o urządzeniu.

SetupDiGetDeviceInstallParams

Pobiera parametry instalacji urządzenia dla zestawu informacji o urządzeniu lub określonego elementu informacji o urządzeniu.

SetupDiSetDeviceInstallParams

Ustawia parametry instalacji urządzenia dla zestawu informacji o urządzeniu lub określonego elementu informacji o urządzeniu.

SetupDiGetDriverInstallParams

Pobiera parametry instalacji dla określonego sterownika.

SetupDiSetDriverInstallParams

Ustawia parametry instalacji określonego sterownika.

Funkcje klasy ustawień

SetupDiBuildClassInfoList

Zwraca listę identyfikatorów GUID klas konfiguracji, które zawierają wszystkie klasy zainstalowane w systemie.

SetupDiBuildClassInfoListEx

Zwraca listę identyfikatorów GUID klasy konfiguracji, która zawiera każdą klasę zainstalowaną w systemie lokalnym lub systemie zdalnym.

SetupDiGetClassDescription

Pobiera opis skojarzonej z określonym identyfikatorem GUID klasy konfiguracji.

SetupDiGetClassDescriptionEx

Pobiera opis klasy konfiguracji zainstalowanej na komputerze lokalnym lub zdalnym.

SetupDiGetINFClass

Pobiera klasę określonego pliku INF urządzenia.

SetupDiClassGuidsFromName

Pobiera identyfikatory GUID skojarzone z określoną nazwą klasy. Ta lista jest oparta na klasach, które są obecnie zainstalowane w systemie.

SetupDiClassGuidsFromNameEx

Pobiera identyfikatory GUID skojarzone z określoną nazwą klasy. Ta wynikowa lista zawiera klasy aktualnie zainstalowane na komputerze lokalnym lub zdalnym.

SetupDiClassNameFromGuid

Pobiera nazwę klasy skojarzoną z identyfikatorem GUID.

SetupDiClassNameFromGuidEx

Pobiera nazwę klasy skojarzoną z identyfikatorem GUID klasy. Klasę można zainstalować na komputerze lokalnym lub zdalnym.

SetupDiInstallClass

Instaluje sekcję ClassInstall32 określonego pliku INF.

SetupDiInstallClassEx

Instaluje instalatora klasy lub klasę interfejsu.

SetupDiOpenClassRegKey

Otwiera klucz rejestru klasy konfiguracji urządzenia lub określony podklucz klasy.

SetupDiOpenClassRegKeyEx

Otwiera klucz rejestru klasy konfiguracji urządzenia, klucz rejestru klasy interfejsu urządzenia lub określony podklucz klasy. Ta funkcja otwiera określony klucz na komputerze lokalnym lub na komputerze zdalnym.

Funkcje mapy bitowej i ikony

SetupDiGetClassImageList

Tworzy listę obrazów zawierającą mapy bitowe dla każdej zainstalowanej klasy i zwraca listę w strukturze danych.

SetupDiGetClassImageListEx

Tworzy listę obrazów map bitowych dla każdej klasy zainstalowanej na komputerze lokalnym lub zdalnym.

SetupDiGetClassImageIndex

Pobiera indeks na liście obrazów dla określonej klasy.

SetupDiGetClassBitmapIndex

Pobiera indeks mini-ikony dostarczonej dla określonej klasy.

SetupDiDrawMiniIcon

Rysuje określoną mini-ikonę w żądanej lokalizacji.

SetupDiLoadClassIcon

Ładuje zarówno ikonę dużą, jak i mini, dla określonej klasy.

SetupDiLoadDeviceIcon

Ładuje ikonę urządzenia dla określonego urządzenia. (Windows Vista i nowsze wersje systemu Windows)

SetupDiDestroyClassImageList

Niszczy listę obrazów klas.

Funkcje interfejsu urządzenia

Uwaga

InstalatorApi nie jest obsługiwany we wszystkich wersjach systemu Windows. Jeśli to możliwe, należy użyć interfejsów API niższej warstwy, takich jak te dostępne za pośrednictwem CfgMgr32.dll. Aby uzyskać porady, zobacz Przenoszenie z setupApi do CfgMgr32 .

SetupDiCreateDeviceInterface

Rejestruje funkcje urządzenia (interfejs urządzenia) dla urządzenia.

SetupDiOpenDeviceInterface

Pobiera informacje o istniejącym interfejsie urządzenia i dodaje je do określonego zestawu informacji o urządzeniu.

SetupDiGetDeviceInterfaceAlias

Zwraca alias określonego interfejsu urządzenia.

SetupDiGetClassDevs

Zwraca zestaw informacji o urządzeniu zawierający wszystkie urządzenia określonej klasy.

SetupDiGetClassDevsEx

Zwraca zestaw informacji o urządzeniu zawierający wszystkie urządzenia określonej klasy na komputerze lokalnym lub zdalnym.

SetupDiEnumDeviceInterfaces

Zwraca strukturę kontekstową elementu interfejsu urządzenia zestawu informacji o urządzeniu. Każde wywołanie zwraca informacje o jednym interfejsie urządzenia.

Funkcję można wywołać wielokrotnie, aby uzyskać informacje o kilku interfejsach udostępnianych przez co najmniej jedno urządzenie.

SetupDiGetDeviceInterfaceDetail

Zwraca szczegóły dotyczące określonego interfejsu urządzenia.

SetupDiCreateDeviceInterfaceRegKey

Tworzy podklucz rejestru do przechowywania informacji o wystąpieniu interfejsu urządzenia i zwraca uchwyt do klucza.

SetupDiOpenDeviceInterfaceRegKey

Otwiera podklucz rejestru używany przez aplikacje i sterowniki do przechowywania informacji specyficznych dla wystąpienia interfejsu urządzenia i zwraca uchwyt do klucza.

SetupDiDeleteDeviceInterfaceRegKey

Usuwa podklucz rejestru używany przez aplikacje i sterowniki do przechowywania informacji specyficznych dla wystąpienia interfejsu urządzenia.

SetupDiInstallDeviceInterfaces

Jest domyślnym mechanizmem obsługi żądania DIF_INSTALLINTERFACES. Instaluje interfejsy wymienione w sekcji DDInstall.Interfaces pliku INF urządzenia.

SetupDiRemoveDeviceInterface

Usuwa zarejestrowany interfejs urządzenia z systemu.

SetupDiDeleteDeviceInterfaceData

Usuwa interfejs urządzenia z zestawu informacji o urządzeniu.

SetupDiSetDeviceInterfaceDefault

Ustawia określony interfejs urządzenia jako interfejs domyślny dla klasy urządzenia.

SetupDiInstallClassEx

Instaluje instalatora klasy lub klasę interfejsu.

SetupDiOpenClassRegKeyEx

Otwiera klucz rejestru klasy konfiguracji urządzenia , klucz rejestru klasy interfejsu urządzenia lub określony podklucz klasy. Ta funkcja otwiera określony klucz na komputerze lokalnym lub na komputerze zdalnym.

Funkcje właściwości urządzenia (Windows Vista i nowsze)

Uwaga

InstalatorApi nie jest obsługiwany we wszystkich wersjach systemu Windows. Jeśli to możliwe, należy użyć interfejsów API niższej warstwy, takich jak te dostępne za pośrednictwem CfgMgr32.dll. Aby uzyskać porady, zobacz Przenoszenie z setupApi do CfgMgr32 .

SetupDiGetClassProperty

Pobiera właściwość urządzenia ustawioną dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia.

SetupDiGetClassPropertyEx

Pobiera właściwość klasy dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia na komputerze lokalnym lub zdalnym.

SetupDiGetClassPropertyKeys

Pobiera tablicę kluczy właściwości urządzenia, które reprezentują właściwości urządzenia ustawione dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia.

SetupDiGetClassPropertyKeysEx

Pobiera tablicę kluczy właściwości urządzenia, które reprezentują właściwości urządzenia ustawione dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia na komputerze lokalnym lub zdalnym.

SetupDiGetDeviceInterfaceProperty

Pobiera właściwość urządzenia ustawioną dla interfejsu urządzenia.

SetupDiGetDeviceInterfacePropertyKeys

Pobiera tablicę kluczy właściwości urządzenia, które reprezentują właściwości urządzenia ustawione dla interfejsu urządzenia.

SetupDiGetDeviceProperty

Pobiera właściwość wystąpienia urządzenia.

SetupDiGetDevicePropertyKeys

Pobiera tablicę kluczy właściwości urządzenia reprezentujących właściwości ustawione dla danego wystąpienia urządzenia.

SetupDiSetClassProperty

Ustawia właściwość klasy dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia.

SetupDiSetClassPropertyEx

Ustawia właściwość urządzenia dla klasy konfiguracji urządzenia lub klasy interfejsu urządzenia na komputerze lokalnym lub zdalnym.

SetupDiSetDeviceInterfaceProperty

Ustawia właściwość interfejsu urządzenia.

SetupDiSetDeviceProperty

Ustawia właściwość wystąpienia urządzenia.

Funkcje rejestru

Uwaga

InstalatorApi nie jest obsługiwany we wszystkich wersjach systemu Windows. Jeśli to możliwe, należy użyć interfejsów API niższej warstwy, takich jak te dostępne za pośrednictwem CfgMgr32.dll. Aby uzyskać porady, zobacz Przenoszenie z setupApi do CfgMgr32 .

SetupDiCreateDevRegKey

Tworzy klucz rejestru dla magazynowania informacji o konfiguracji specyficznej dla urządzenia i zwraca uchwyt do tego klucza.

SetupDiOpenDevRegKey

Otwiera klucz magazynu rejestru dla informacji o konfiguracji specyficznej dla urządzenia i zwraca uchwyt do tego klucza.

SetupDiDeleteDevRegKey

Usuwa określone klucze rejestru dostępne dla użytkownika skojarzone z elementem informacji o urządzeniu.

SetupDiOpenClassRegKey

Otwiera klucz rejestru klasy konfiguracji (setup), lub określony podklucz tej klasy.

SetupDiOpenClassRegKeyEx

Otwiera klucz rejestru klasy konfiguracji urządzenia, klucz rejestru klasy interfejsu urządzenia lub określony podklucz klasy.

Ta funkcja otwiera określony klucz na komputerze lokalnym lub na komputerze zdalnym.

SetupDiCreateDeviceInterfaceRegKey

Tworzy nieulotny podklucz rejestru do przechowywania informacji o instancji interfejsu urządzenia i zwraca uchwyt do tego klucza.

SetupDiOpenDeviceInterfaceRegKey

Otwiera podklucz rejestru, którego używają aplikacje i sterowniki do przechowywania informacji specyficznych dla wystąpienia interfejsu urządzenia, i zwraca uchwyt do tego klucza.

SetupDiDeleteDeviceInterfaceRegKey

Usuwa podklucz rejestru używany przez aplikacje i sterowniki do przechowywania informacji specyficznych dla wystąpienia interfejsu urządzenia.

SetupDiSetDeviceRegistryProperty

Ustawia określoną właściwość urządzenia Plug and Play.

SetupDiGetDeviceRegistryProperty

Pobiera określoną właściwość urządzenia Plug and Play.

SetupDiGetClassRegistryProperty

Pobiera określoną właściwość klasy urządzenia z rejestru.

SetupDiSetClassRegistryProperty

Ustawia określoną właściwość klasy urządzenia w rejestrze.

Inne funkcje

SetupDiGetActualModelsSection

Pobiera odpowiednią przystosowaną sekcję modeli INF do użycia podczas instalowania urządzenia z pliku INF urządzenia.

SetupDiGetActualSectionToInstall

Pobiera odpowiednią sekcję DDInstall do użycia podczas instalowania urządzenia z pliku INF urządzenia.

SetupDiGetActualSectionToInstallEx

Pobiera nazwę sekcji INF DDInstall , która instaluje urządzenie dla określonego systemu operacyjnego i architektury procesora.

SetupDiGetHwProfileFriendlyName

Pobiera przyjazną nazwę skojarzoną z identyfikatorem profilu sprzętowego.

SetupDiGetHwProfileFriendlyNameEx

Pobiera przyjazną nazwę skojarzoną z identyfikatorem profilu sprzętowego na komputerze lokalnym lub zdalnym.

SetupDiGetHwProfileList

Pobiera listę wszystkich aktualnie zdefiniowanych identyfikatorów profilów sprzętu.

SetupDiGetHwProfileListEx

Pobiera listę wszystkich aktualnie zdefiniowanych identyfikatorów profilów sprzętowych na komputerze lokalnym lub zdalnym.

SetupDiRestartDevices

Uruchamia ponownie określone urządzenie lub, w razie potrzeby, uruchamia wszystkie urządzenia obsługiwane przez tę samą funkcję i sterowniki filtru co określone urządzenie.