SP_DRVINFO_DATA_V1_A Struktur (setupapi.h)
Eine SP_DRVINFO_DATA Struktur enthält Informationen zu einem Treiber. Diese Struktur ist ein Mitglied einer Treiberinformationsliste, die einer bestimmten Geräteinstanz oder global einem Geräteinformationssatz zugeordnet werden kann.
Syntax
typedef struct _SP_DRVINFO_DATA_V1_A {
DWORD cbSize;
DWORD DriverType;
ULONG_PTR Reserved;
CHAR Description[LINE_LEN];
CHAR MfgName[LINE_LEN];
CHAR ProviderName[LINE_LEN];
} SP_DRVINFO_DATA_V1_A, *PSP_DRVINFO_DATA_V1_A;
Angehörige
cbSize
Die Größe der SP_DRVINFO_DATA Struktur in Byte. Weitere Informationen finden Sie im Abschnitt "Hinweise" in diesem Thema.
DriverType
Der Typ des Treibers, der durch diese Struktur dargestellt wird. Muss einer der folgenden Werte sein:
SPDIT_CLASSDRIVER
Diese Struktur stellt einen Klassentreiber dar.
SPDIT_COMPATDRIVER
Diese Struktur stellt einen kompatiblen Treiber dar.
Reserved
Reserviert. Nur für die interne Verwendung.
Description[LINE_LEN]
Eine MIT NULL beendete Zeichenfolge, die das von diesem Treiber unterstützte Gerät beschreibt.
MfgName[LINE_LEN]
Eine MIT NULL beendete Zeichenfolge, die den Namen des Herstellers des Geräts enthält, das von diesem Treiber unterstützt wird.
ProviderName[LINE_LEN]
Eine MIT NULL beendete Zeichenfolge, die den Anbieter dieses Treibers angibt. Dies ist in der Regel der Name der Organisation, die den Treiber oder die INF-Datei erstellt. ProviderName- kann eine leere Zeichenfolge sein.
Bemerkungen
In SetupAPI.hentspricht diese Struktur entweder SP_DRVINFO_DATA_V1 oder SP_DRVINFO_DATA_V2, je nachdem, ob Sie die folgende Zeile in den Quellcode einschließen:
#define USE_SP_DRVINFO_DATA_V1 1
Definieren Sie diesen Bezeichner nur, wenn Ihre Komponente unter Windows 98 oder Millennium Edition oder unter Windows NT ausgeführt werden muss. Wenn Ihre Komponente nur in Windows 2000 und höheren Versionen von Windows ausgeführt wird, definieren Sie den Bezeichner nicht. Wenn der Bezeichner nicht definiert ist, wird SP_DRVINFO_DATA_V2 verwendet.
SP_DRVINFO_DATA_V1 enthält DriverDate- und DriverVersion--Member nicht.
SetupDi-Xxx--Funktionen, die eine SP_DRVINFO_DATA Struktur als Parameter verwenden, überprüfen, ob das cbSize Element der angegebenen Struktur der Größe in Byte entspricht. Wenn das cbSize Member für einen Eingabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt einen Fehlercode von ERROR_INVALID_PARAMETER fest. Wenn das cbSize Member für einen Ausgabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt einen Fehlercode von ERROR_INVALID_USER_BUFFER fest.
Anmerkung
Der header setupapi.h definiert SP_DRVINFO_DATA_V1 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | setupapi.h (include Setupapi.h) |