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

Member

cbSize

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

DriverType

Der Von dieser Struktur dargestellte Treibertyp. 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 NULL-beendete 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.

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 das cbSize-Element der angegebenen Struktur der Größe (in Bytes) der Struktur entspricht. Wenn der 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 der 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.

Hinweis

Der setupapi.h-Header 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.