SP_DRVINSTALL_PARAMS-Struktur (setupapi.h)
Eine SP_DRVINSTALL_PARAMS-Struktur enthält Treiberinstallationsparameter, die einem bestimmten Treiberinformationselement zugeordnet sind.
Syntax
typedef struct _SP_DRVINSTALL_PARAMS {
DWORD cbSize;
DWORD Rank;
DWORD Flags;
DWORD_PTR PrivateData;
DWORD Reserved;
} SP_DRVINSTALL_PARAMS, *PSP_DRVINSTALL_PARAMS;
Member
cbSize
Die Größe der SP_DRVINSTALL_PARAMS-Struktur in Bytes.
Rank
Die Ranggleichung dieses Treibers. Reicht von 0 bis n, wobei 0 am kompatibelsten ist.
Flags
Flags, die funktionen steuern, die auf diesem Treiber ausgeführt werden. Dies kann eine Kombination aus folgenden Komponenten sein:
DNF_ALWAYSEXCLUDEFROMLIST (Windows Vista und höhere Versionen von Windows)
Wenn dieses Flag festgelegt ist, wird verhindert, dass der Treiberknoten aufgezählt wird, unabhängig vom Client, der die Enumeration ausführt.
DNF_AUTHENTICODE_SIGNED (Windows Server 2003 und höhere Versionen von Windows)
Die INF-Datei dieses Treibers wird von einer Authenticode-Signatur signiert. Dieses Flag ist für Installationsprogramme schreibgeschützt.
Weitere Informationen finden Sie unter Using SetupAPI to Verify Driver Authenticode Signatures.For more information, see Using SetupAPI to Verify Driver Authenticode Signatures.
DNF_BAD_DRIVER
Verwenden Sie diesen Treiber nicht. Installer können dieses Flag lesen und schreiben.
Wenn dieses Flag festgelegt ist, ignorieren SetupDiSelectBestCompatDrv und SetupDiSelectDevice diesen Treiber.
Ein Klasseninstallationsprogramm oder Co-Installer kann dieses Flag festlegen, um zu verhindern, dass Windows den Treiber im Dialogfeld Treiber auswählen auflistet. Ein Installationsprogramm kann dieses Flag festlegen, wenn es beispielsweise eine DIF_SELECTDEVICE - oder DIF_SELECTBESTCOMPATDRV-Anforderung verarbeitet.
DNF_BASIC_DRIVER (Windows XP und höhere Versionen von Windows)
Dieser Treiber ist ein Basistreiber. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_CLASS_DRIVER
Dieser Treiber ist ein Klassentreiber. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_COMPATIBLE_DRIVER
Dieser Treiber ist ein kompatibler Treiber. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_DUPDESC
Es gibt andere Anbieter, die Treiber bereitstellen, die dieselbe Beschreibung wie dieser Treiber haben. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_DUPDRIVERVER (Windows XP und höhere Versionen von Windows)
Es gibt andere Anbieter, die Treiber mit derselben Version wie dieser Treiber bereitstellen. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_DUPPROVIDER
Es gibt andere Anbieter, die Treiber bereitstellen, die dieselbe Beschreibung wie dieser Treiber haben. Der einzige Unterschied zwischen diesem Treiber und seiner Übereinstimmung ist das Treiberdatum. Dieses Flag ist für Installationsprogramme schreibgeschützt.
Wenn dieses Flag festgelegt ist, zeigt Windows das Treiberdatum und die Treiberversion neben dem Treiber an, damit der Benutzer es von seiner Übereinstimmung unterscheiden kann.
DNF_EXCLUDEFROMLIST
Zeigen Sie diesen Treiber nicht in Treiberauswahldialogen an.
DNF_INBOX_DRIVER (Windows Vista und höhere Versionen von Windows)
Dieser Treiberknoten wird von einer INF-Datei abgeleitet, die in dieser Version von Windows enthalten war.
DNF_INET_DRIVER
Dieser Treiber kam aus dem Internet oder aus Windows Update. Dieses Flag ist für Installationsprogramme schreibgeschützt.
Wenn Sie SetupCopyOEMInf aufrufen, müssen Sie das SPOST_URL-Flag angeben, damit Windows diese INF beim Kopieren dieses INF-Verzeichnisses in das Verzeichnis %SystemRoot%\als Internet-INF markiert. Wenn Sie diesen Schritt auslassen, versucht Windows, dieses Gerät zum Installieren anderer Geräte zu verwenden. Das daraus resultierende Problem besteht darin, dass Windows nicht mehr über die Quelldateien verfügt und den Benutzer mit einem ungültigen Pfad auffordert.
DNF_INF_IS_SIGNED (Windows XP und höhere Versionen von Windows)
Dieses Flag ist für Installationsprogramme schreibgeschützt und wird festgelegt, wenn eine der folgenden Bedingungen zutrifft:
- Der Treiber verfügt über eine WHQL-Releasesignatur.
- Der Treiber ist ein Posteingangstreiber.
- Der Treiber verfügt über eine Authenticode-Signatur.
DNF_INSTALLEDDRIVER (Windows Vista und höhere Versionen von Windows)
Dieser Treiberknoten ist derzeit für das Gerät installiert. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_LEGACYINF
Dieser Treiber stammt aus einer älteren INF-Datei. Dieses Flag ist nur für das NT-basierte Betriebssystem gültig. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_NODRIVER
Legen Sie fest, wenn für diesen logischen Treiber kein physischer Treiber installiert werden soll.
DNF_OEM_F6_INF (Windows XP und höhere Versionen von Windows)
Reserviert.
DNF_OLD_INET_DRIVER
Dieser Treiber kam aus dem Internet, aber Windows hat derzeit keinen Zugriff auf seine Quelldateien. Dieses Flag ist für Installationsprogramme schreibgeschützt.
Das System installiert keinen Treiber, der mit diesem Flag gekennzeichnet ist, da Windows nicht über die Quelldateien verfügt und den Benutzer am Ende mit einem ungültigen Pfad auffordert. Der INF für einen solchen Treiber kann für alles verwendet werden, mit Ausnahme der Installation von Geräten.
DNF_OLDDRIVER
Dieser Treiber hat derzeit/zuvor das zugeordnete Gerät gesteuert. Dieses Flag ist für Installationsprogramme schreibgeschützt.
DNF_REQUESTADDITIONALSOFTWARE (Windows 7 und höhere Versionen von Windows)
Legen Sie dieses Flag fest, wenn das Treiberpaket nur Teil der Softwarelösung ist, die für den Betrieb des Geräts erforderlich ist. In diesem Fall erfordert das Treiberpaket die Installation zusätzlicher Software.
Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
PrivateData
Ein Feld, das ein Klasseninstallationsprogramm verwenden kann, um private Daten zu speichern. Co-Installer sollten dieses Feld nicht verwenden.
Reserved
Reserviert. Nur zur internen Verwendung.
Hinweise
Ab Windows 7 kann ein Installer oder Co-Installer das DNF_REQUESTADDITIONALSOFTWARE-Flag festlegen, um anzugeben, dass das Treiberpaket zusätzliche Software erfordert, die auf dem Computer installiert werden kann oder nicht.
Nachdem das Treiberpaket für das Gerät installiert wurde, führt der Plug & Play-Manager (PnP) die folgenden Schritte aus, wenn das Installationsprogramm das DNF_REQUESTADDITIONALSOFTWARE-Flag festlegt:
- Der PnP-Manager generiert einen Fehlerbericht zu Problembericht und Lösung (PRS) mit dem Typ RequestAddtionalSoftware. Dieser Bericht enthält Informationen zur spezifischen Hardware-ID des Geräts und zur Systemarchitektur des Computers.
-
Wenn es eine Lösung gibt, die vom unabhängigen Hardwarehersteller (Independent Hardware Vendor, IHV) für die gerätespezifische Software bereitgestellt wird, wird die Lösung auf den Computer heruntergeladen.
Hinweis Beim Herunterladen der Lösung wird die Software selbst nicht installiert.
- Wenn die gerätespezifische Software nicht auf dem Computer installiert ist, stellt der PnP-Manager dem Benutzer die Lösung vor und stellt einen Link zum Herunterladen der Software bereit. Der Benutzer kann diese Software dann herunterladen und installieren, indem er den Anweisungen in der Lösung folgt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | setupapi.h (schließen Sie Setupapi.h ein) |