DEVPKEY_DrvPkg_Icon

  • Artikel

Die DEVPKEY_DrvPkg_Icon-Geräteeigenschaft stellt eine Liste von Gerätesymbolen dar, die Windows verwendet, um ein Gerät instance visuell darzustellen.

attribute Wert
Eigenschaftenschlüssel DEVPKEY_DrvPkg_Icon
Eigenschaftsdatentypbezeichner DEVPROP_TYPE_STRING_LIST
Eigenschaftenzugriff Schreibgeschützter Zugriff durch Installationsanwendungen und Installationsprogramme
Lokalisierte Ja

Bemerkungen

Jedes Symbol in der Liste wird durch einen Pfad einer Symboldatei (*.ico) oder einen Verweis auf eine Symbolressource in einer ausführbaren Datei angegeben.

Das erste Symbol in der Liste wird als Standard verwendet. Es können zusätzliche Symbole bereitgestellt werden, die unterschiedliche visuelle Darstellungen eines Geräts bereitstellen. Windows enthält eine Benutzeroberfläche, mit der ein Benutzer auswählen kann, welches Symbol von Windows angezeigt wird. Die Microsoft DiscoveryCam 530 ist beispielsweise in blau, grün und rot verfügbar. Microsoft stellt für jede Farbe ein Symbol bereit. Windows verwendet standardmäßig das blaue Symbol, da es sich um das erste Symbol in der Liste handelt. Windows-Benutzer können jedoch auch das grüne oder das rote Symbol auswählen.

Die Symbolliste ist eine DURCH NULL getrennte Liste von Symbolbezeichnern. Ein Symbolspezifizierer ist entweder ein Pfad einer Symboldatei (*.ico) oder ein Symbolressourcenspezifizierer, wie folgt:

  • Das Format des Pfads zu einer Symboldatei lautet DirectoryPath\filename.ico.

  • Ein Symbolressourcenspezifizierer weist die folgenden Einträge auf:

    @executable-file-path,resource-identifier

    Das erste Zeichen des Symbolressourcenspezifizierers ist das At-Zeichen (@), gefolgt vom Pfad einer ausführbaren Datei (einer *.exe oder einer *.dll-Datei ), gefolgt von einem Kommatrennzeichen (,) und dann dem Eintrag ressourcenbezeichner .

Der Symbolspezifizierer "@shell32.dll,-30" stellt beispielsweise die ausführbare Datei "shell32.dll" und den Ressourcenbezeichner "-30" dar.

Ein Ressourcenbezeichner muss wie folgt ein ganzzahliger Wert sein, der einer Ressource in der ausführbaren Datei entspricht:

  • Wenn der angegebene Bezeichner negativ ist, verwendet Windows die Ressource in der ausführbaren Datei, deren Bezeichner dem absoluten Wert des angegebenen Bezeichners entspricht.

  • Wenn der angegebene Bezeichner null ist, verwendet Windows die Ressource in der ausführbaren Datei, deren Bezeichner den niedrigsten Wert in der ausführbaren Datei aufweist.

  • Wenn der angegebene Bezeichner positiv ist, z. B. der Wert n, verwendet Windows die Ressource in der ausführbaren Datei, deren Bezeichner der niedrigste Wert n+1 in der ausführbaren Datei ist. Wenn der Wert von n beispielsweise 1 ist, verwendet Windows die Ressource, deren Bezeichner den zweitniedrigsten Wert in der ausführbaren Datei aufweist.

Sie können den Wert von DEVPKEY_DrvPkg_Icon durch eine INF AddProperty-Direktive festlegen, die im Abschnitt INF DDInstall der INF-Datei enthalten ist, die das Gerät installiert. Sie können den Wert von DEVPKEY_DrvPkg_Icon abrufen, indem Sie CM_Get_DevNode_Property oder SetupDiGetDeviceProperty aufrufen.

Im Folgenden finden Sie ein Beispiel für die Verwendung einer INF AddProperty-Direktive , um DEVPKEY_DrvPkg_Icon für ein Gerät festzulegen, das von einem INF DDInstall-Abschnitt "SampleDDInstallSection" installiert wird:

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

[SampleAddPropertySection] 
DeviceIcon,,,,"SomeResource.dll,-2","SomeIcon.icon"
...

Anforderungen

Version: Windows Vista und höhere Versionen von Windows

Header: Devpkey.h (devpkey.h einschließen)

Weitere Informationen

INF AddProperty-Direktive

ABSCHNITT "INF DDInstall"

SetupDiGetDeviceProperty