Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die DEVPKEY_DrvPkg_Icon Geräteeigenschaft stellt eine Liste von Gerätesymbolen dar, die Windows verwendet, um eine Geräteinstanz visuell darzustellen.
| Attribut | Wert |
|---|---|
| Eigenschaftsschlüssel | DEVPKEY_DrvPkg_Icon |
| Eigenschaftendatentypbezeichner | DEVPROP_TYPE_STRING_LIST |
| Eigenschaftenzugriff | Schreibgeschützter Zugriff durch Installationsanwendungen und Installationsprogramme |
| Lokalisiert | Yes |
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. Zusätzliche Symbole können bereitgestellt werden, die unterschiedliche visuelle Darstellungen eines Geräts bereitstellen. Windows enthält eine Benutzeroberfläche, über die ein Benutzer auswählen kann, welches Symbol Windows angezeigt wird. Beispielsweise ist die Microsoft DiscoveryCam 530 in Blau, Grün und Rot verfügbar. Microsoft liefert ein Symbol für jede Farbe. Windows verwendet standardmäßig das blaue Symbol, da es sich um den ersten in der Liste handelt. Windows Benutzer können jedoch auch das grüne Symbol oder das rote Symbol auswählen.
Die Symbolliste ist eine DURCH NULL getrennte Liste mit Symbolbezeichnern. Ein Symbolbezeichner ist entweder ein Pfad einer Symboldatei (*.ico) oder ein Symbolressourcenbezeichner wie folgt:
Das Format des Pfads zu einer Symboldatei ist DirectoryPath\filename.ico.
Ein Symbolressourcenbezeichner hat die folgenden Einträge:
@executable-file-path,resource-identifierDas erste Zeichen des Symbolressourcenbezeichners ist das At-Zeichen (@) gefolgt vom Pfad einer ausführbaren Datei (ein *.exe oder eine *.dll Datei), gefolgt von einem Kommatrennzeichen (,) und dann dem Ressourcenbezeichnereintrag .
Beispielsweise stellt der Symbolbezeichner"@shell32.dll,-30" die ausführbare Datei "shell32.dll" und den Ressourcenbezeichner "-30" dar.
Ein Ressourcenbezeichner muss ein ganzzahliger Wert sein, der einer Ressource innerhalb der ausführbaren Datei entspricht, wie folgt:
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 z. B. positiv ist, verwendet Windows die Ressource in der ausführbaren Datei, deren Bezeichner der n+1 niedrigste Wert in der ausführbaren Datei ist. Wenn der Wert n beispielsweise 1 ist, verwendet Windows die Ressource, deren Bezeichner den zweiten niedrigsten 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 sehen 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"
...
Requirements
Version: Windows Vista und höhere Versionen von Windows
Header: Devpkey.h (include Devpkey.h)