SP_DEVINFO_DATA-Struktur (setupapi.h)
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) |