SP_DRVINFO_DATA_V2_A-Struktur (setupapi.h)

Artikel
08/26/2023

Eine SP_DRVINFO_DATA-Struktur enthält Informationen zu einem Treiber. Diese Struktur ist ein Mitglied einer Treiberinformationsliste, die einem bestimmten Gerät instance oder global einem Geräteinformationssatz zugeordnet werden kann.

Syntax

typedef struct _SP_DRVINFO_DATA_V2_A {
  DWORD     cbSize;
  DWORD     DriverType;
  ULONG_PTR Reserved;
  CHAR      Description[LINE_LEN];
  CHAR      MfgName[LINE_LEN];
  CHAR      ProviderName[LINE_LEN];
  FILETIME  DriverDate;
  DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_A, *PSP_DRVINFO_DATA_V2_A;

Member

cbSize

Die Größe der SP_DRVINFO_DATA-Struktur in Bytes. Weitere Informationen finden Sie im Abschnitt Hinweise in diesem Thema.

DriverType

Der Typ des Treibers, der durch diese Struktur dargestellt wird. Dies 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 zur internen Verwendung.

Description[LINE_LEN]

Eine MIT NULL endende Zeichenfolge, die das gerät beschreibt, das von diesem Treiber unterstützt wird.

MfgName[LINE_LEN]

Eine NULL-beendete Zeichenfolge, die den Namen des Herstellers des Geräts enthält, das von diesem Treiber unterstützt wird.

ProviderName[LINE_LEN]

Eine NULL-beendete Zeichenfolge, die den Anbieter dieses Treibers angibt. Dies ist in der Regel der Name des organization, der den Treiber oder die INF-Datei erstellt. ProviderName kann eine leere Zeichenfolge sein.

DriverDate

Datum des Treibers. Aus dem DriverVer-Eintrag in der INF-Datei. Weitere Informationen zum DriverVer-Eintrag finden Sie im Abschnitt INF DDInstall.

DriverVersion

Version des Treibers. Aus dem DriverVer-Eintrag in der INF-Datei.

Hinweise

In SetupAPI.h entspricht diese Struktur entweder SP_DRVINFO_DATA_V1 oder SP_DRVINFO_DATA_V2, je nachdem, ob Sie die folgende Zeile in Ihren 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 keine DriverDate- und DriverVersion-Member .

SetupDiXxx-Funktionen , die eine SP_DRVINFO_DATA Struktur als Parameter verwenden, überprüfen, ob der cbSize-Member der angegebenen Struktur gleich der Größe der Struktur in Bytes ist. Wenn der cbSize-Member für einen Eingabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt den Fehlercode ERROR_INVALID_PARAMETER fest. Wenn der cbSize-Member für einen Ausgabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt den Fehlercode ERROR_INVALID_USER_BUFFER fest.

Hinweis

Der Header setupapi.h definiert SP_DRVINFO_DATA_V2 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.