本節包含 Setupapi.h 標頭的參考主題。
本節內容
| 主題 | 說明 |
|---|---|
| SetupDiAskForOEMDisk |
SetupDiAskForOEMDisk 函式會顯示對話框，詢問使用者 OEM 安裝磁碟的路徑。 |
| SetupDiBuildClassInfoList |
SetupDiBuildClassInfoList 函式會傳回安裝類別 GUID 的清單，以識別安裝在本機電腦上的類別。 |
| SetupDiBuildClassInfoListEx |
SetupDiBuildClassInfoListEx 函式會傳回安裝類別 GUID 的清單，其中包含安裝在本機系統或遠端系統上的每個類別。 |
| SetupDiBuildDriverInfoList |
SetupDiBuildDriverInfoList 函式會建置與特定裝置相關聯的驅動程式清單，或與裝置資訊集的全域類別驅動程式清單相關聯。 |
| SetupDiCallClassInstaller |
SetupDiCallClassInstaller 函式會呼叫適當的類別安裝程式，以及任何已註冊的共同安裝程式，並具有指定的安裝要求（DIF 程式代碼）。 |
| SetupDiCancelDriverInfoSearch |
SetupDiCancelDriverInfoSearch 函式會取消目前在不同的線程中進行中的驅動程式清單搜尋。 |
| SetupDiChangeState |
SetupDiChangeState 函式是安裝要求DIF_PROPERTYCHANGE的預設處理程式。 |
| SetupDiClassGuidsFromName |
SetupDiClassGuidsFromName 函式會擷取與指定類別名稱相關聯的 GUID（s）。 此清單是根據系統上目前安裝的類別所建置。 |
| SetupDiClassGuidsFromNameEx |
SetupDiClassGuidsFromNameEx 函式會擷取與指定類別名稱相關聯的 GUID。 這個產生的清單包含目前安裝在本機或遠端電腦上的類別。 |
| SetupDiClassNameFromGuid |
SetupDiClassNameFromGuid 函式會擷取與類別 GUID 相關聯的類別名稱。 |
| SetupDiClassNameFromGuidEx |
SetupDiClassNameFromGuidEx 函式會擷取與類別 GUID 相關聯的類別名稱。 類別可以安裝在本機或遠端電腦上。 |
| SetupDiCreateDeviceInfo |
SetupDiCreateDeviceInfo 函式會建立新的裝置資訊元素，並將它新增為指定裝置資訊集的新成員。 |
| SetupDiCreateDeviceInfoList |
SetupDiCreateDeviceInfoList 函式會建立空的裝置資訊集，並選擇性地將集合與裝置設定類別和最上層窗口產生關聯。 |
| SetupDiCreateDeviceInfoListEx |
SetupDiCreateDeviceInfoList 函式會在遠端或本機電腦上建立空的裝置資訊集，並選擇性地將集合與裝置安裝類別產生關聯。 |
| SetupDiCreateDeviceInterface |
SetupDiCreateDeviceInterface 函式會在本機系統或遠端系統上註冊裝置介面。 |
| SetupDiCreateDeviceInterfaceRegKey |
SetupDiCreateDeviceInterfaceRegKey 函式會建立登錄機碼來儲存裝置介面的相關信息，並將句柄傳回密鑰。 |
| SetupDiCreateDevRegKey |
SetupDiCreateDevRegKey 函式會建立裝置特定組態資訊的登錄機碼，並傳回密鑰的句柄。 |
| SetupDiDeleteDeviceInfo |
SetupDiDeleteDeviceInfo 函式會從裝置資訊集刪除裝置資訊元素。 此函式不會刪除實際的裝置。 |
| SetupDiDeleteDeviceInterfaceData |
SetupDiDeleteDeviceInterfaceData 函式會從裝置資訊集刪除裝置介面。 |
| SetupDiDeleteDeviceInterfaceRegKey |
SetupDiDeleteDeviceInterfaceRegKey 函式會刪除應用程式和驅動程式用來儲存介面特定資訊的登錄子機碼。 |
| SetupDiDeleteDevRegKey |
SetupDiDeleteDevRegKey 函式會刪除與裝置資訊專案相關聯的指定使用者可存取登錄機碼。 |
| SetupDiDestroyClassImageList |
SetupDiDestroyClassImageList 函式會終結呼叫 SetupDiGetClassImageList 或 SetupDiGetClassImageListEx 所建置的類別映射列表。 |
| SetupDiDestroyDeviceInfoList |
SetupDiDestroyDeviceInfoList 函式會刪除裝置資訊集，並釋放所有相關聯的記憶體。 |
| SetupDiDestroyDriverInfoList |
SetupDiDestroyDriverInfoList 函式會刪除驅動程序清單。 |
| SetupDiDrawMiniIcon |
SetupDiDrawMiniIcon 函式會在所要求的位置繪製指定的迷你圖示。 |
| SetupDiEnumDeviceInfo |
SetupDiEnumDeviceInfo 函式會傳回SP_DEVINFO_DATA結構，指定裝置資訊集中的裝置資訊元素。 |
| SetupDiEnumDeviceInterfaces |
SetupDiEnumDeviceInterfaces 函式會列舉裝置資訊集中所包含的裝置介面。 |
| SetupDiEnumDriverInfo |
SetupDiEnumDriverInfo 函式會列舉驅動程式列表的成員。 |
| SetupDiFinishInstallAction |
SetupDiFinishInstallAction 函式是DIF_FINISHINSTALL_ACTION要求的默認處理程式。 |
| SetupDiGetActualModelsSection |
SetupDiGetActualModelsSection 函式會擷取從裝置 INF 檔案安裝裝置時要使用的適當裝飾 INF 模型區段。 |
| SetupDiGetActualSectionToInstall |
SetupDiGetActualSectionToInstall 函式會擷取適當的 INF DDInstall 區段，以在本機電腦上安裝裝置 INF 檔案時使用。 |
| SetupDiGetActualSectionToInstallEx |
SetupDiGetActualSectionToInstallEx 函式會擷取為指定操作系統和處理器架構安裝裝置的 INF DDInstall 區段名稱。 |
| SetupDiGetClassBitmapIndex |
SetupDiGetClassBitmapIndex 函式會擷取為指定類別提供的迷你圖示索引。 |
| SetupDiGetClassDescription |
SetupDiGetClassDescription 函式會擷取與指定之安裝類別 GUID 相關聯的類別描述。 |
| SetupDiGetClassDescriptionEx |
SetupDiGetClassDescriptionEx 函式會擷取安裝在本機或遠端電腦上之安裝類別的描述。 |
| SetupDiGetClassDevPropertySheets |
SetupDiGetClassDevPropertySheets 函式會擷取裝置資訊元素的屬性表或裝置資訊集的裝置安裝類別的句柄。 |
| SetupDiGetClassDevs |
SetupDiGetClassDevs 函式會傳回包含本機計算機所要求裝置資訊元素的裝置資訊集句柄。 |
| SetupDiGetClassDevsEx |
SetupDiGetClassDevsEx 函式會傳回裝置資訊集的句柄，其中包含本機或遠端電腦要求的裝置資訊元素。 |
| SetupDiGetClassImageIndex |
SetupDiGetClassImageIndex 函式會擷取指定類別之類別影像清單中的索引。 |
| SetupDiGetClassImageList |
SetupDiGetClassImageList 函式會建置影像清單，其中包含每個已安裝類別的位圖，並傳回數據結構中的清單。 |
| SetupDiGetClassImageListEx |
SetupDiGetClassImageListEx 函式會建置本機或遠端系統上所安裝之每個類別的位圖影像清單。 |
| SetupDiGetClassInstallParams |
SetupDiGetClassInstallParams 函式會擷取裝置資訊集或特定裝置資訊元素的類別安裝參數。 |
| SetupDiGetClassProperty |
SetupDiGetClassProperty 函式會擷取裝置安裝類別或裝置介面類別所設定的裝置屬性。 |
| SetupDiGetClassPropertyEx |
SetupDiGetClassPropertyEx 函式會擷取本機或遠端電腦上裝置安裝類別或裝置介面類別的類別屬性。 |
| SetupDiGetClassPropertyKeys |
SetupDiGetClassPropertyKeys 函式會擷取裝置屬性索引鍵的數位，代表為裝置安裝類別或裝置介面類別所設定的裝置屬性。 |
| SetupDiGetClassPropertyKeysEx |
SetupDiGetClassPropertyKeysEx 函式會擷取裝置屬性索引鍵的數位，代表針對本機或遠端電腦上裝置安裝類別或裝置介面類別所設定的裝置屬性。 |
| SetupDiGetClassRegistryProperty |
SetupDiGetClassRegistryProperty 函式會從登錄擷取指定裝置安裝類別的屬性。 |
| SetupDiGetCustomDeviceProperty |
SetupDiGetCustomDeviceProperty 函式會從登錄擷取指定的自定義裝置屬性。 |
| SetupDiGetDeviceInfoListClass |
如果 set 具有相關聯的類別，則 SetupDiGetDeviceInfoListClass 函式會擷取與裝置資訊集相關聯的裝置安裝類別的 GUID。 |
| SetupDiGetDeviceInfoListDetail |
SetupDiGetDeviceInfoListDetail 函式會擷取與裝置資訊集相關聯的資訊，包括類別 GUID、遠端電腦句柄和遠端電腦名稱。 |
| SetupDiGetDeviceInstallParams |
SetupDiGetDeviceInstallParams 函式會擷取裝置資訊集或特定裝置資訊元素的裝置安裝參數。 |
| SetupDiGetDeviceInstanceId |
SetupDiGetDeviceInstanceId 函式會擷取與裝置資訊專案相關聯的裝置實例標識符。 |
| SetupDiGetDeviceInterfaceAlias |
SetupDiGetDeviceInterfaceAlias 函式會傳回指定裝置介面的別名。 |
| SetupDiGetDeviceInterfaceDetail |
SetupDiGetDeviceInterfaceDetail 函式會傳回裝置介面的詳細數據。 |
| SetupDiGetDeviceInterfaceProperty |
SetupDiGetDeviceInterfaceProperty 函式會擷取為裝置介面設定的裝置屬性。 |
| SetupDiGetDeviceInterfacePropertyKeys |
SetupDiGetDeviceInterfacePropertyKeys 函式會擷取代表裝置介面所設定之裝置屬性的裝置屬性索引鍵數位。 |
| SetupDiGetDeviceProperty |
SetupDiGetDeviceProperty 函式會擷取裝置實例屬性。 |
| SetupDiGetDevicePropertyKeys |
SetupDiGetDevicePropertyKeys 函式會擷取代表裝置實例所設定之裝置屬性的裝置屬性索引鍵數位。 |
| SetupDiGetDeviceRegistryProperty |
SetupDiGetDeviceRegistryProperty 函式會擷取指定的 隨插即用 裝置屬性。 |
| SetupDiGetDriverInfoDetail |
SetupDiGetDriverInfoDetail 函式會擷取裝置資訊集或裝置資訊集中特定裝置資訊元素的驅動程式資訊詳細數據。 |
| SetupDiGetDriverInstallParams |
SetupDiGetDriverInstallParams 函式會擷取裝置資訊集或特定裝置資訊元素的驅動程式安裝參數。 |
| SetupDiGetHwProfileFriendlyName |
SetupDiGetHwProfileFriendlyName 函式會擷取與硬體配置文件標識符相關聯的易記名稱。 |
| SetupDiGetHwProfileFriendlyNameEx |
SetupDiGetHwProfileFriendlyNameEx 函式會擷取與本機或遠端電腦上硬體配置檔標識符相關聯的易記名稱。 |
| SetupDiGetHwProfileList |
SetupDiGetHwProfileList 函式會擷取所有目前定義之硬體配置檔標識符的清單。 |
| SetupDiGetHwProfileListEx |
SetupDiGetHwProfileListEx 函式會擷取本機或遠端電腦上目前定義之所有硬體配置檔標識碼的清單。 |
| SetupDiGetINFClass |
SetupDiGetINFClass 函式會傳回指定裝置 INF 檔案的類別。 |
| SetupDiGetSelectedDevice |
SetupDiGetSelectedDevice 函式會擷取裝置資訊集中選取的裝置資訊元素。 |
| SetupDiGetSelectedDriver |
SetupDiGetSelectedDriver 函式會擷取所選驅動程式，以取得裝置資訊集或特定裝置資訊元素。 |
| SetupDiInstallClass |
SetupDiInstallClass 函式會安裝指定 INF 檔案的 ClassInstall32 區段。 |
| SetupDiInstallClassEx |
SetupDiInstallClassEx 函式會安裝類別安裝程式或介面類別。 |
| SetupDiInstallDevice |
SetupDiInstallDevice 函式是安裝要求DIF_INSTALLDEVICE的預設處理程式。 |
| SetupDiInstallDeviceInterfaces |
SetupDiInstallDeviceInterfaces 函式是安裝要求DIF_INSTALLINTERFACES的預設處理程式。 |
| SetupDiInstallDriverFiles |
SetupDiInstallDriverFiles 函式是DIF_INSTALLDEVICEFILES安裝要求的預設處理程式。 |
| SetupDiLoadClassIcon |
SetupDiLoadClassIcon 函式會同時載入指定類別的大型和迷你圖示。 |
| SetupDiLoadDeviceIcon |
SetupDiLoadDeviceIcon 函式會擷取指定裝置的圖示。 |
| SetupDiOpenClassRegKey |
SetupDiOpenClassRegKey 函式會開啟安裝程式類別登錄機碼或特定類別的子機碼。 |
| SetupDiOpenClassRegKeyEx |
SetupDiOpenClassRegKeyEx 函式會開啟裝置安裝類別登錄機碼、裝置介面類別登錄機碼或特定類別的子機碼。 此函式會在本機電腦或遠端電腦上開啟指定的金鑰。 |
| SetupDiOpenDeviceInfo |
SetupDiOpenDeviceInfo 函式會將裝置實例的裝置資訊元素新增至裝置資訊集，如果裝置資訊集中還沒有裝置資訊集，則會擷取資訊，以識別裝置資訊集中裝置實例的裝置資訊元素。 |
| SetupDiOpenDeviceInterface |
SetupDiOpenDeviceInterface 函式會擷取裝置介面的相關信息，並將介面新增至本機系統或遠端系統所設定的指定裝置資訊。 |
| SetupDiOpenDeviceInterfaceRegKey |
SetupDiOpenDeviceInterfaceRegKey 函式會開啟應用程式和驅動程式用來儲存裝置介面專屬資訊的登錄子機碼。 |
| SetupDiOpenDevRegKey |
SetupDiOpenDevRegKey 函式會開啟裝置特定組態資訊的登錄機碼。 |
| SetupDiRegisterCoDeviceInstallers |
SetupDiRegisterCoDeviceInstallers 函式是DIF_REGISTER_COINSTALLERS的默認處理程式。 |
| SetupDiRegisterDeviceInfo |
SetupDiRegisterDeviceInfo 函式是DIF_REGISTERDEVICE要求的默認處理程式。 |
| SetupDiRemoveDevice |
SetupDiRemoveDevice 函式是DIF_REMOVE安裝要求的預設處理程式。 |
| SetupDiRemoveDeviceInterface |
SetupDiRemoveDeviceInterface 函式會從系統移除已註冊的裝置介面。 |
| SetupDiRestartDevices |
SetupDiRestartDevices 函式會重新啟動指定的裝置，或在必要時重新啟動相同函式所操作的所有裝置，以及操作指定裝置的篩選驅動程式。 |
| SetupDiSelectBestCompatDrv |
SetupDiSelectBestCompatDrv 函式是安裝要求DIF_SELECTBESTCOMPATDRV的預設處理程式。 |
| SetupDiSelectDevice |
SetupDiSelectDevice 函式是DIF_SELECTDEVICE要求的默認處理程式。 |
| SetupDiSelectOEMDrv |
SetupDiSelectOEMDrv 函式會選取驅動程式作為裝置資訊集，或是使用使用者提供之 OEM 路徑的特定裝置資訊元素。 |
| SetupDiSetClassInstallParams |
SetupDiSetClassInstallParams 函式會設定或清除裝置資訊集或特定裝置資訊元素的類別安裝參數。 |
| SetupDiSetClassProperty |
SetupDiSetClassProperty 函式會設定裝置安裝類別或裝置介面類別的類別屬性。 |
| SetupDiSetClassPropertyEx |
SetupDiSetClassPropertyEx 函式會為本機或遠端電腦上的裝置安裝類別或裝置介面類別設定裝置屬性。 |
| SetupDiSetClassRegistryProperty |
SetupDiSetClassRegistryProperty 函式會在登錄中設定指定的裝置類別屬性。 |
| SetupDiSetDeviceInstallParams |
SetupDiSetDeviceInstallParams 函式會設定裝置資訊集或特定裝置資訊元素的裝置安裝參數。 |
| SetupDiSetDeviceInterfaceDefault |
SetupDiSetDeviceInterfaceDefault 函式會將裝置介面設定為裝置介面類別的預設介面。 |
| SetupDiSetDeviceInterfaceProperty |
SetupDiSetDeviceInterfaceProperty 函式會設定裝置介面的裝置屬性。 |
| SetupDiSetDeviceProperty |
SetupDiSetDeviceProperty 函式會設定裝置實例屬性。 |
| SetupDiSetDeviceRegistryProperty |
SetupDiSetDeviceRegistryProperty 函式會設定裝置的 隨插即用 裝置屬性。 |
| SetupDiSetDriverInstallParams |
SetupDiSetDriverInstallParams 函式會設定驅動程式資訊元素的驅動程式安裝參數。 |
| SetupDiSetSelectedDevice |
SetupDiSetSelectedDevice 函式會將裝置資訊元素設定為裝置資訊集的選取成員。 安裝精靈通常會使用此函式。 |
| SetupDiSetSelectedDriver |
SetupDiSetSelectedDriver 函式會設定或重設裝置資訊元素的選取驅動程式，或針對裝置資訊集選取的類別驅動程式。 |
| SetupDiUnremoveDevice |
SetupDiUnremoveDevice 函式是安裝要求DIF_UNREMOVE的預設處理程式。 |
| SetupGetInfDriverStoreLocation |
SetupGetInfDriverStoreLocation 函式會擷取驅動程式存放區中 INF 檔案的完整檔名（目錄路徑和檔名），該檔案對應至系統 INF 檔案目錄中的指定 INF 檔案，或驅動程式存放區中的指定 INF 檔案。 |
| SetupGetInfPublishedName |
SetupGetInfPublishedName 函式會擷取系統 INF 檔案目錄中 INF 檔案的完整檔名（目錄路徑和檔名），該檔案對應至驅動程式存放區中指定的 INF 檔案，或系統 INF 檔案目錄中的指定 INF 檔案。 |
| SetupGetNonInteractiveMode |
SetupGetNonInteractiveMode 函式會傳回 SetupAPI 非互動式旗標的值，指出呼叫端的進程是否可以透過使用者介面元件來與用戶互動，例如對話方塊。 |
| SetupGetThreadLogToken |
SetupGetThreadLogToken 函式會擷取呼叫此函式之線程的記錄令牌。 |
| SetupSetNonInteractiveMode |
SetupSetNonInteractiveMode 函式會設定非互動式 SetupAPI 旗標，以判斷 SetupAPI 是否可以與呼叫端內容中的用戶互動。 |
| SetupSetThreadLogToken |
SetupSetThreadLogToken 函式會針對呼叫此函式的線程，設定記錄內容，如記錄標記所代表。 在相同線程內對 SetupGetThreadLogToken 的後續呼叫會擷取最近針對線程設定的記錄令牌。 |
| SetupWriteTextLog |
SetupWriteTextLog 函式會在 SetupAPI 文字記錄檔中寫入記錄專案。 |
| SetupWriteTextLogError |
SetupWriteTextLogError 函式會將 SetupAPI 特定錯誤或 Win32 系統錯誤的相關信息寫入 SetupAPI 文字記錄檔。 |
| SetupWriteTextLogInfLine |
SetupWriteTextLogInfLine 函式會在 SetupAPI 文字記錄檔中寫入記錄專案，其中包含指定 INF 檔案行的文字。 |
| SP_ADDPROPERTYPAGE_DATA |
安裝程式會在處理DIF_ADDPROPERTYPAGE_ADVANCED要求時，使用SP_ADDPROPERTYPAGE_DATA結構來提供裝置的自定義屬性頁。 |
| SP_ALTPLATFORM_INFO |
SP_ALTPLATFORM_INFO 結構會指定指定計算機的操作系統版本和計算機的處理器架構。 |
| SP_CLASSIMAGELIST_DATA |
SP_CLASSIMAGELIST_DATA 結構描述類別影像清單。 |
| SP_CLASSINSTALL_HEADER |
SP_CLASSINSTALL_HEADER是任何類別安裝參數結構的第一個成員。 它包含裝置安裝要求程式碼，可定義其餘安裝參數結構的格式。 |
| SP_DETECTDEVICE_PARAMS |
SP_DETECTDEVICE_PARAMS 結構會對應至DIF_DETECT安裝要求。 |
| SP_DEVICE_INTERFACE_DATA |
SP_DEVICE_INTERFACE_DATA結構會定義裝置資訊集中的裝置介面。 |
| SP_DEVICE_INTERFACE_DETAIL_DATA |
SP_DEVICE_INTERFACE_DETAIL_DATA結構包含裝置介面的路徑。 |
| SP_DEVINFO_DATA |
SP_DEVINFO_DATA 結構會定義裝置實例，該實例是裝置資訊集的成員。 |
| SP_DEVINFO_LIST_DETAIL_DATA |
SP_DEVINFO_LIST_DETAIL_DATA結構包含裝置資訊集的相關信息，例如其相關聯的安裝類別 GUID（如果它有相關聯的安裝類別）。 |
| SP_DEVINSTALL_PARAMS |
SP_DEVINSTALL_PARAMS結構包含與特定裝置資訊元素相關聯的裝置安裝參數，或與裝置資訊集全域相關聯的裝置安裝參數。 |
| SP_DRVINFO_DATA |
SP_DRVINFO_DATA 結構包含驅動程式的相關信息。 此結構是驅動程式資訊清單的成員，可以與特定裝置實例或全域與裝置資訊集相關聯。 |
| SP_DRVINFO_DETAIL_DATA |
SP_DRVINFO_DETAIL_DATA 結構包含特定驅動程式資訊結構的詳細資訊。 |
| SP_DRVINSTALL_PARAMS |
SP_DRVINSTALL_PARAMS 結構包含與特定驅動程式資訊元素相關聯的驅動程式安裝參數。 |
| SP_NEWDEVICEWIZARD_DATA |
安裝程式會使用SP_NEWDEVICEWIZARD_DATA結構，藉由新增自定義頁面來擴充硬體安裝精靈的作業。 它會與 DIF_NEWDEVICEWIZARD_XXX 安裝要求搭配使用。 |
| SP_POWERMESSAGEWAKE_PARAMS |
SP_POWERMESSAGEWAKE_PARAMS 結構會對應至 DIF_POWERMESSAGEWAKE 安裝要求。 |
| SP_PROPCHANGE_PARAMS |
SP_PROPCHANGE_PARAMS結構對應至 DIF_PROPERTYCHANGE 安裝要求。 |
| SP_PROPSHEETPAGE_REQUEST |
SP_PROPSHEETPAGE_REQUEST結構可以當做第一個參數 （lpv） 傳遞至 SetupAPI DLL 中的 ExtensionPropSheetPageProc 進入點。 ExtensionPropSheetPageProc 可用來擷取指定屬性表頁面的句柄。 如需 ExtensionPropSheetPageProc 和相關函式的相關信息，請參閱 Microsoft Windows SDK 檔。 |
| SP_REMOVEDEVICE_PARAMS |
SP_REMOVEDEVICE_PARAMS結構會對應至 DIF_REMOVE 安裝要求。 |
| SP_SELECTDEVICE_PARAMS |
SP_SELECTDEVICE_PARAMS 結構會對應至 DIF_SELECTDEVICE 安裝要求。 |
| SP_TROUBLESHOOTER_PARAMS |
SP_TROUBLESHOOTER_PARAMS 結構會對應至 DIF_TROUBLESHOOTER 安裝要求。 |
| SP_UNREMOVEDEVICE_PARAMS |
SP_UNREMOVEDEVICE_PARAMS結構對應至DIF_UNREMOVE安裝要求。 |