Düzenle

DEVPKEY_DrvPkg_DetailedDescription

The DEVPKEY_DrvPkg_DetailedDescription device property represents a detailed description of the capabilities of a device instance.

Attribute Value
Property key DEVPKEY_DrvPkg_DetailedDescription
Property-data-type identifier DEVPROP_TYPE_STRING
Data format Limited set of XML tags
Property access Read-only access by installation applications and installers
Localized? Yes

Remarks

The detailed description string is in XML format. XML format makes it possible for Windows to format the display of the information based on the following subset of supported Hypertext Markup Language (HTML) tags. The operation of these tags resembles the operation of HTML tags.

  • Heading level tags

    <h1>, <h2>, <h3>

  • List tags

    <ul>, <ol>, <li>

  • Paragraph tag

    <p>

You can set the value of DEVPKEY_DrvPkg_DetailedDescription by an INF AddProperty directive that is included in the INF DDInstall section of the INF file that installs the device. You can retrieve the value of DEVPKEY_DrvPkg_DetailedDescription by calling CM_Get_DevNode_Property or SetupDiGetDeviceProperty.

The following is an example of how to use an INF AddProperty directive to set the value of DEVPKEY_DrvPkg_DetailedDescription for a device instance that is installed by an INF DDInstall section "SampleDDInstallSection":

[SampleDDinstallSection]
...
AddProperty=SampleAddPropertySection
...

[SampleAddPropertySection] 
DeviceDetailedDescription,,,,"<xml><h1>Microsoft DiscoveryCam 530</h1><h2>Overview<h2>The Microsoft DiscoveryCam is great.<p>Really.<p><h2>Features</h2>The Microsoft DiscoveryCam has three features.<ol><li>Feature 1</li><li>Feature 2</li><li>Feature 3</li></ol></xml>"
...

Requirements

Version: Windows Vista and later versions of Windows

Header: Devpkey.h (include Devpkey.h)

See also

INF AddProperty Directive

INF DDInstall Section

SetupDiGetDeviceProperty