Troubleshooting the metadata authoring wizards

[This topic describes the Device Metadata Authoring tool provided in the Windows Driver Kit (WDK) 8. If you’re developing device experiences for Windows 8.1, use the Device Metadata Authoring Wizard available with Microsoft Visual Studio 2013 and Windows Driver Kit (WDK) 8.1. For more information, see Windows 8.1 device experience. ]

If you receive any of the following error messages, refer to the Resolution column in the table to resolve the issue.

Tool Screen Error message Resolution
Metadata Authoring Wizard Welcome ERROR: You must specify a folder location Enter a folder path.
Welcome ERROR: FolderLocation.Text folder does not exist Correct the file path.
Welcome The chosen file doesn't exist Correct the file path or name.
Welcome XML File error

Correct the XML error.

Error examples:

  • Was expecting the first child of {0} to be {1}, but found {2} instead.
  • Was expecting {0} to be followed by {1}, but found {2} instead.
Finish Package creation failed:

Change the parameter based on the instructions.

Error examples:

  • You must specify the ModelName for the device (locale {0})
  • You must associate this package with at least one HardwareID or ModelID
  • You must specify a primary category for this device

Warning examples:

  • ModelNumber ({0}) is not specified
  • DeviceDescription 2 ({0}) is not specified
  • The generic icon will be determined by the primary category selection
Association Invalid format : "Value" - don't add { } in the beginning and end. Remove the {} and try again.
Association Invalid GUID format: "Value" Type the correct GUID and try again.
Icon There were problems with the icon file: "Error Message" Icon Validation Error The icon can't be found or doesn't meet the requirement to be displayed in Devices and Printers in Control Panel. Find or fix the icon and try again.

Error examples:

  • Error: Image 256x256 transparency needs to be set.
  • Error: Image 48x48:32bit+Alpha does not exist.
Submission Wizard Select metadata packages There is already a package with that name in the list Create a new GUID for the device metadata package.
Select metadata packages There was a problem loading the package: Change the parameter based on the instructions.
Finish There was a problem creating the submission package: Change the parameter based on the instructions.

Send comments about this topic to Microsoft