SP_DEVICE_INTERFACE_DATA-Struktur (setupapi.h)

Artikel
03/04/2024

Eine SP_DEVICE_INTERFACE_DATA-Struktur definiert eine Geräteschnittstelle in einem Geräteinformationssatz.

Syntax

typedef struct _SP_DEVICE_INTERFACE_DATA {
  DWORD     cbSize;
  GUID      InterfaceClassGuid;
  DWORD     Flags;
  ULONG_PTR Reserved;
} SP_DEVICE_INTERFACE_DATA, *PSP_DEVICE_INTERFACE_DATA;

Member

cbSize

Die Größe der SP_DEVICE_INTERFACE_DATA Struktur in Bytes. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

InterfaceClassGuid

Die GUID für die Klasse, zu der die Geräteschnittstelle gehört.

Flags

Kann mindestens eine der folgenden Elemente sein:

SPINT_ACTIVE

Die Schnittstelle ist aktiv (aktiviert).

SPINT_DEFAULT

Die Schnittstelle ist die Standardschnittstelle für die Geräteklasse.

SPINT_REMOVED

Die Schnittstelle wird entfernt.

Reserved

Reserviert. Darf nicht verwendet werden.

Hinweise

Eine SetupAPI-Funktion, die einen instance der SP_DEVICE_INTERFACE_DATA-Struktur als Parameter verwendet, überprüft, ob das cbSize-Element der angegebenen Struktur der Größe der Struktur in Bytes entspricht. Wenn der cbSize-Member nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt einen Fehlercode von ERROR_INVALID_USER_BUFFER fest.