Install a battery driver

Artikkeli
08/26/2024

A battery driver's INF file specifies information about the driver and the devices it controls. All battery devices belong to the Battery class, and the battery class installer installs the driver.

This section describes battery-specific entries in the INF file. For more information about creating and distributing INF files and installing drivers, see Creating an INF File and INF File Sections and Directives.

A battery driver's INF file includes the sections described below.

Version

A battery driver's INF file specifies the Battery class and its GUID, using the INF Version section, as shown in the following example:

[Version]
Signature="$WINDOWS NT$"
Class=Battery
ClassGuid={72631e54-78a4-11d0-bcf7-00aa00b7b32a}
Provider=%MyCo%
CatalogFile=ExampleCatalog.cat
PnpLockdown=1

Note that %MyCo% must be defined in an INF Strings section (not shown).

DestinationDirs

In the INF DestinationDirs section, a battery driver's INF specifies the Drivers directory (12) as the default for all files.

[DestinationDirs]
DefaultDestDir = 12

Manufacturer

The INF Manufacturer section defines the manufacturer of the device.

[Manufacturer]
%MyCo%=MyCompany,NTamd64

Models

The INF Models section specifies the PnP hardware ID of the battery (shown as pnpid in the example). If the device is enumerated through ACPI, this section must also specify the EISA-style ID (shown as acpidevnum). For information about creating these IDs, see the Advanced Configuration and Power Interface Specification, which is available through the ACPI / Power Management website.

[MyCompany.NTamd64]
%pnpid.DeviceDesc% = NewBatt_Inst,pnpid
%ACPI\acpidevnum.DeviceDesc% = NewBatt_Inst,ACPI\acpidevnum

DDInstall

In the INF DDInstall section (named NewBatt_Inst in the example), an INF CopyFiles directive copies the battery class driver (Battc.sys) and the new miniclass driver (NewBatt.sys) to the destination specified in the DestinationDirs directive.

[NewBatt_Inst]
CopyFiles = @NewBatt.sys
CopyFiles = @battc.sys

DDInstall.Services

The INF DDInstall.Services section includes an INF AddService directive that specifies additional information about the battery driver. A battery driver's INF file should indicate that the driver is a kernel driver that uses normal error handling and starts during initialization of the operating system. Battery drivers specify the load order group Extended Base.

[NewBatt_Inst.Services]
AddService = NewBatt,2,NewBatt_Service_Inst    ; function driver for the device
 
[NewBatt_Service_Inst]
DisplayName    = %NewBatt.SvcDesc%
ServiceType    = 1 ;    SERVICE_KERNEL_DRIVER
StartType      = 3 ;    SERVICE_DEMAND_START
ErrorControl   = 1 ;    SERVICE_ERROR_NORMAL%
ServiceBinary  = %12%\NewBatt.sys

Jaa