Muokkaa

Jaa


Summary of INF Directives

The following list summarizes many (but not all) of the directives that can be used in INF files. INF directive names are case-insensitive. For example, Addreg, addReg, and AddReg are equally valid as directive specifications within an INF file.

This section lists the most commonly used directives first, together with their reciprocal or related directives. The most rarely used directives are toward the end of the list.

AddReg Directive
This directive references one or more add-registry-sections, which are INF sections used to add or modify subkeys and value entries in the registry.

The particular INF section in which an AddReg directive resides determines the default, relative registry location that will receive modifications specified in the referenced add-registry-section. These default registry locations are typically device-specific or driver-specific subkeys.

Additional add-registry-sections can set up registry information for system-defined device interfaces (such as kernel streaming interfaces) exported to higher level drivers, for new device interfaces exported by an installed component for a given class of devices, or for driver services.

CopyFiles Directive
This directive references one or more file-list-sections specifying transfers of model/device-specific driver images and any other necessary files from the distribution media to the destination directory for each such file.

AddService Directive
This directive references at least a service-install-section, possibly with an additional event-log-install-section.

INF files for most kinds of devices (those that install drivers) have an INF-writer-defined service-install-section to specify any dependencies on system-supplied drivers or services, during which stage of the system initialization process the supplied drivers should be loaded, and so forth. Many INF files for device drivers also have an INF-writer-defined event-log-install-section that is referenced by the AddService directive to set up event logging by the device driver.

AddInterface Directive
This directive references an add-interface-section in which one or more AddReg directives are specified referencing sections that set up the registry entries for the device interfaces supported by this device/driver.

DelReg Directive
Note If you are building a universal or "Windows Driver" driver package, this directive is not valid. See Using a Universal INF File.

This directive references one or more del-registry-sections used to remove obsolete subkeys and/or value entries from the registry. For example, such a section might appear in an INF that upgrades a previous installation.

DelFiles Directive
Note If you are building a universal or "Windows Driver" driver package, this directive is not valid. See Using a Universal INF File.

This rarely used directive references one or more file-list-sections specifying files to be deleted from the target of the installation.

DelService Directive
Note If you are building a universal or "Windows Driver" driver package, this directive is not valid. See Using a Universal INF File.

This rarely used directive deletes a previously installed service.

LogConfig Directive
Note If you are building a universal or "Windows Driver" driver package, this directive is not valid. See Using a Universal INF File.

This directive references one or more log-config-sections that specify acceptable bus-relative and device-specific hardware configurations in an INF for devices that are detected (by PnP device enumerators) or manually installed. For example, INF files for non-PnP ISA, EISA, and MCA devices, which are manually installed, use this directive. (Also see INF DDInstall.LogConfigOverride Section.)