SP_DEVINFO_DATA-Struktur (setupapi.h)

  • Artikel

Eine SP_DEVINFO_DATA-Struktur definiert ein Gerät instance, das Mitglied eines Geräteinformationssatzes ist.

Syntax

typedef struct _SP_DEVINFO_DATA {
  DWORD     cbSize;
  GUID      ClassGuid;
  DWORD     DevInst;
  ULONG_PTR Reserved;
} SP_DEVINFO_DATA, *PSP_DEVINFO_DATA;

Member

cbSize

Die Größe der SP_DEVINFO_DATA Struktur in Bytes. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

ClassGuid

Die GUID der Setupklasse des Geräts.

DevInst

Ein undurchsichtiges Handle für das Gerät instance (auch als Handle für den Devnode bezeichnet).

Einige Funktionen, z. B . SetupDiXxx-Funktionen , verwenden die gesamte SP_DEVINFO_DATA-Struktur als Eingabe, um ein Gerät in einem Geräteinformationssatz zu identifizieren. Andere Funktionen, z. B . CM_Xxx-Funktionen wie CM_Get_DevNode_Status, verwenden dieses DevInst-Handle als Eingabe.

Reserved

Reserviert. Nur zur internen Verwendung.

Hinweise

Eine SP_DEVINFO_DATA Struktur identifiziert ein Gerät in einem Geräteinformationssatz. Wenn Windows beispielsweise eine DIF_INSTALLDEVICE Anforderung an einen Klasseninstallationsprogramm und Co-Installer sendet, enthält es ein Handle auf einen Geräteinformationssatz und einen Zeiger auf einen SP_DEVINFO_DATA, der das jeweilige Gerät angibt. Zusätzlich zu DIF-Anforderungen wird diese Struktur auch in einigen SetupDiXxx-Funktionen verwendet.

SetupDiXxx-Funktionen , die eine SP_DEVINFO_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.

Anforderungen

   
Kopfzeile setupapi.h (einschließlich Setupapi.h)

Weitere Informationen

SP_DEVINFO_LIST_DETAIL_DATA