SP_DRVINFO_DATA_V2_A Struktur (setupapi.h)

Artikel
11/20/2024

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_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;

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.

DriverDate

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

DriverVersion

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

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_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.