Skip to content

Latest commit

 

History

History
85 lines (65 loc) · 4.19 KB

nf-setupapi-setupdiinstalldeviceinterfaces.md

File metadata and controls

85 lines (65 loc) · 4.19 KB
Raw
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
NF:setupapi.SetupDiInstallDeviceInterfaces
SetupDiInstallDeviceInterfaces function (setupapi.h)
The SetupDiInstallDeviceInterfaces function is the default handler for the DIF_INSTALLINTERFACES installation request.
SetupDiInstallDeviceInterfaces
SetupDiInstallDeviceInterfaces function [Device and Driver Installation]
devinst.setupdiinstalldeviceinterfaces
di-rtns_8bb9c70f-c1be-45f6-af6c-243a750babb9.xml
setupapi/SetupDiInstallDeviceInterfaces
devinst\setupdiinstalldeviceinterfaces.htm
devinst
c47d83f6-9ae5-43a9-a6ed-b0441b490e8d
12/05/2018
SetupDiInstallDeviceInterfaces, SetupDiInstallDeviceInterfaces function [Device and Driver Installation], devinst.setupdiinstalldeviceinterfaces, di-rtns_8bb9c70f-c1be-45f6-af6c-243a750babb9.xml, setupapi/SetupDiInstallDeviceInterfaces
setupapi.h
Setupapi.h
Desktop
Available in Microsoft Windows 2000 and later versions of Windows.
Setupapi.lib
Setupapi.dll
Windows
19H1
SetupDiInstallDeviceInterfaces
setupapi/SetupDiInstallDeviceInterfaces
c++
APIRef
kbSyntax
DllExport
Setupapi.dll
SetupDiInstallDeviceInterfaces

SetupDiInstallDeviceInterfaces function

-description

The SetupDiInstallDeviceInterfaces function is the default handler for the DIF_INSTALLINTERFACES installation request.

-parameters

-param DeviceInfoSet [in]

A pointer to the device information set that contains a device information element that represents the device for which to install interfaces. The device information set must contain only elements for the local system.

-param DeviceInfoData [in]

A pointer to an SP_DEVINFO_DATA structure that specifies the device information element in DeviceInfoSet.

-returns

SetupDiInstallDeviceInterfaces returns TRUE if the function completed without error. If the function completed with an error, FALSE is returned and the error code for the failure can be retrieved by calling GetLastError.

-remarks

SetupDiInstallDeviceInterfaces processes each AddInterface entry in the DDInstall.Interfaces section of a device INF file and creates each interface by calling SetupDiCreateDeviceInterface.

The caller of SetupDiInstallDeviceInterfaces must be a member of the Administrators group.

Note  Only a class installer should call SetupDiInstallDeviceInterfaces and only in those situations where the class installer must perform device interface installation operations after SetupDiInstallDeviceInterfaces completes the default device interface installation operation. In such situations, the class installer must directly call SetupDiInstallDeviceInterfaces when the installer processes a DIF_INSTALLINTERFACES request. For more information about calling the default handler, see Calling Default DIF Code Handlers.
 
For information about INF file format, see INF File Sections and Directives.

-see-also

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface