Skip to content

Latest commit

 

History

History
92 lines (67 loc) · 3.95 KB

nf-setupapi-setupdicreatedeviceinfolist.md

File metadata and controls

92 lines (67 loc) · 3.95 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:setupapi.SetupDiCreateDeviceInfoList
SetupDiCreateDeviceInfoList function (setupapi.h)
The SetupDiCreateDeviceInfoList function creates an empty device information set and optionally associates the set with a device setup class and a top-level window.
SetupDiCreateDeviceInfoList
SetupDiCreateDeviceInfoList function [Device and Driver Installation]
devinst.setupdicreatedeviceinfolist
di-rtns_8b7e7f05-0c72-4ae0-aee7-b88e8a59cc63.xml
setupapi/SetupDiCreateDeviceInfoList
devinst\setupdicreatedeviceinfolist.htm
devinst
0596f422-39ff-41ea-8bbd-63381d418ec8
12/05/2018
SetupDiCreateDeviceInfoList, SetupDiCreateDeviceInfoList function [Device and Driver Installation], devinst.setupdicreatedeviceinfolist, di-rtns_8b7e7f05-0c72-4ae0-aee7-b88e8a59cc63.xml, setupapi/SetupDiCreateDeviceInfoList
setupapi.h
Setupapi.h
Desktop
Available in Microsoft Windows 2000 and later versions of Windows.
Setupapi.lib
Setupapi.dll
Windows
19H1
SetupDiCreateDeviceInfoList
setupapi/SetupDiCreateDeviceInfoList
c++
APIRef
kbSyntax
DllExport
Setupapi.dll
Ext-MS-Win-SetupAPI-ClassInstallers-l1-1-1.dll
Ext-MS-Win-SetupAPI-ClassInstallers-L1-1-2.dll
SetupDiCreateDeviceInfoList
ext-ms-win-setupapi-classinstallers-l1-1-1 (introduced in Windows 8.1)

SetupDiCreateDeviceInfoList function

-description

The SetupDiCreateDeviceInfoList function creates an empty device information set and optionally associates the set with a device setup class and a top-level window.

-parameters

-param ClassGuid [in, optional]

A pointer to the GUID of the device setup class to associate with the newly created device information set. If this parameter is specified, only devices of this class can be included in this device information set. If this parameter is set to NULL, the device information set is not associated with a specific device setup class.

-param hwndParent [in, optional]

A handle to the top-level window to use for any user interface that is related to non-device-specific actions (such as a select-device dialog box that uses the global class driver list). This handle is optional and can be NULL. If a specific top-level window is not required, set hwndParent to NULL.

-returns

The function returns a handle to an empty device information set if it is successful. Otherwise, it returns INVALID_HANDLE_VALUE. To get extended error information, call GetLastError.

-remarks

The caller of this function must delete the returned device information set when it is no longer needed by calling SetupDiDestroyDeviceInfoList.

To create a device information list for a remote computer use SetupDiCreateDeviceInfoListEx.

-see-also

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass