CreateFromINF Method in Class SMS_Driver

Article
10/04/2022

The CreateFromINF Windows Management Instrumentation (WMI) class method, in Configuration Manager, creates an SMS_Driver Server WMI Class object based on information from the specified Microsoft Windows .inf file.

The following syntax is simplified from Managed Object Format (MOF) code and defines the method.

Syntax

SInt32 CreateFromINF(  
      String DriverPath,  
      String INFFile,  
      SMS_Driver Driver  
);

Parameters

DriverPath
Data type: String

Qualifiers: [in]

Valid Universal Naming Convention (UNC) network path to the folder that contains the driver contents. For example, \\Servers\Driver\VideoDriver.

INFFile
Data type: String

Qualifiers: [in]

The name of the INF file.

Driver
Data type: SMS_Driver

Qualifiers: [out]

An SMS_Driver Server WMI Class object with a complete driver catalog.

Return Values

An SInt32 data type that is 0 to indicate success or nonzero to indicate failure. The error values are available in the SMS_ExtendedStatus Server WMI Class error object. For information about handling returned errors, see About Configuration Manager Errors.

Possible error values include, but aren't limited to, the following:

0
Success

13
The driver is invalid

1633
The driver is valid but doesn't support any platforms supported by Configuration Manager.

2
The SMS Provider can't access the network share.

183
The driver has already been imported.

To find out specifics of an error, see the OSDDriverCatalog.log file.

Remarks

A driver is represented by an information file (INF). The INF file is a text file that specifies the files that need to be present or downloaded for the operating system to run. The information in this type of file provides installation instructions that the Internet Component Download service provided in Microsoft Internet Explorer 3.0 or later uses to install and register software components that are downloaded from the Internet, in addition to any files required by the components.

Note

Your application should create a driver only by calling this method or the CreateFromOEM Method in Class SMS_Driver. It should never create a driver directly.

This method creates a new SMS_Driver Server WMI Class object.

Once created, the SMS_Driver Server WMI ClassSDMPackageXML contains the driver definition XML. To set the display information used by the Configuration Manager console for the driver, you need to set the localization information in the SMS_Driver Server WMI ClassLocalizedInformation property. The driver name used by the display from is available in SMS_Driver Server WMI ClassSDMPackageXML property XML. For more information, see How to Import a Windows Driver Described by an INF File into Configuration Manager.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

Share via