Microsoft KB Archive/888728

= A description of the device driver .inf file decoration requirements for Windows Server 2003 x64 Editions and Windows XP Professional x64 Edition =

Article ID: 888728

Article Last Modified on 10/11/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, Standard x64 Edition
 * Microsoft Windows Server 2003, Enterprise x64 Edition
 * Microsoft Windows XP Professional x64 Edition

-



INTRODUCTION
Microsoft Windows Server 2003 x64 editions and Microsoft Windows XP Professional x64 Edition require that OEM device driver .inf files specify a TargetOsVersion entry in the [Manufacturer] section and in the [Models] section for the following 64-bit computer platforms:
 * Intel Itanium
 * Advanced Micro Devices (AMD) AMD64 processors and Intel Extended Memory 64 Technology (EM64T)

If the TargetOsVersion entry is specified with a suffix for a particular platform and operating system, the .inf file is considered to be decorated. Decoration is designed to prevent users from trying to install .inf-based device driver packages on a platform that is not correct. For example, with Windows Server 2003-based and earlier operating systems, Plug and Play tries to install a 32-bit x86 device driver that has an undecorated .inf file on an Itanium-based platform. When a platform mismatch is detected, the device installation is not completed successfully. Typically, if the device installation is not completed successfully, limited information is returned to the user. This may make troubleshooting device installation problems difficult.



MORE INFORMATION
The following sample .inf file excerpt shows the [Manufacturer] and the [Models] sections with a TargetOSVersion decoration that specifies the 64-bit-based platform.

Note The .NTamd64 decoration in the following .inf file excerpt is used for all AMD64 or EM64T platforms. Conversely, the .NTia64 decoration is used for Intel Itanium platforms.

[Manufacturer]

%mycompany% = Models, NTamd64

[ Models.NTamd64]

%MyDev% = mydevInstall, mydevHwid

Decorations and installation behavior
The following table describes the Microsoft Windows operating system installation behaviors for decorated and undecorated .inf files:

Decorations and installation behavior notes
(I) Device models that are within the corresponding .inf file are found, and are matched for potential installation.

(NI) Device models that are within the corresponding .inf file are not found, and installation does not occur.

(*) Undecorated .inf files for Itanium-based platforms are allowed for packages with a DriverVer date that is before the date that is defined in Windows Server 2003 x64 editions. This is to avoid problems that may be caused by device driver packages that are developed before the date that is defined in Windows Server 2003 x64 editions.

Device driver .inf files that are used for multiple platforms
Device driver .inf files support the following multiple platform configurations:
 * Decorated sections for x64 and Itanium-based platforms.
 * Undecorated or decorated sections for x86-based platforms.

Important You cannot install device driver packages with decorated .inf files on Windows 2000-based computers. Only Windows Server 2003 x64 editions and Windows XP Professional x64 Edition support .inf file decoration.

The following two methods are supported with device driver packages for multiple platforms:
 * Method 1: Provide an individual .inf file for each operating system.
 * Method 2: Provide a single multiple-platform .inf file for all supported platforms.

Note Method 1 is the preferred method because it requires only a single declaration in the [Models] section of the .inf file.

The following example shows a multiple platform .inf file:

[Manufacturer]

%mycompany% = Models, NTx86, NTia64

[ Models.NTx86]

%MyDev% = mydevInstallx86, mydevHwid

[ Models.NTia64]

%MyDev% = mydevInstallia64, mydevHwid

For more information about how to create .inf files for multiple platforms, see the &quot;Creating INF Files for Multiple Platforms and Operating Systems&quot; topic in the Windows Driver Development Kit documentation.

Backward compatibility with Windows Server 2003 for Itanium-based platforms
Windows compares the DriverVer date of an .inf file to determine whether a decorated [Models] section is required. For backward compatibility purposes with Itanium-based platforms, Windows Server 2003 x64 editions do not enforce .inf decorations for device drivers if the DriverVer date is earlier than the date that is defined in Windows Server 2003 x64 editions.

The enforcement date is maintained in the following registry subkey:

For more information about device driver .inf file decoration, visit the following Microsoft Web site:

http://www.microsoft.com/whdc/driver/install/64INF_reqs.mspx

Technical support for Windows x64 editions
Your hardware manufacturer provides technical support and assistance for Microsoft Windows x64 editions. Your hardware manufacturer provides support because a Windows x64 edition was included with your hardware. Your hardware manufacturer might have customized the Windows x64 edition installation with unique components. Unique components might include specific device drivers or might include optional settings to maximize the performance of the hardware. Microsoft will provide reasonable-effort assistance if you need technical help with your Windows x64 edition. However, you might have to contact your manufacturer directly. Your manufacturer is best qualified to support the software that your manufacturer installed on the hardware.

For product information about Microsoft Windows XP Professional x64 Edition, visit the following Microsoft Web site:

http://www.microsoft.com/windowsxp/64bit/default.mspx

For product information about Microsoft Windows Server 2003 x64 editions, visit the following Microsoft Web site:

http://www.microsoft.com/windowsserver2003/64bit/x64/default.mspx

Additional query words: pnp ddk Winx64 Windowsx64 64bit 64-bit

Keywords: kbhowto kbinfo KB888728

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.