SP_DEVICE_INTERFACE_DETAIL_DATA_W-Struktur (setupapi.h)

  • Artikel

Eine SP_DEVICE_INTERFACE_DETAIL_DATA-Struktur enthält den Pfad für eine Geräteschnittstelle.

Syntax

typedef struct _SP_DEVICE_INTERFACE_DETAIL_DATA_W {
  DWORD cbSize;
  WCHAR DevicePath[ANYSIZE_ARRAY];
} SP_DEVICE_INTERFACE_DETAIL_DATA_W, *PSP_DEVICE_INTERFACE_DETAIL_DATA_W;

Member

cbSize

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

DevicePath[ANYSIZE_ARRAY]

Eine NULL-beendete Zeichenfolge, die den Geräteschnittstellenpfad enthält. Dieser Pfad kann an Win32-Funktionen wie CreateFile übergeben werden.

Hinweise

Eine SP_DEVICE_INTERFACE_DETAIL_DATA-Struktur identifiziert den Pfad für eine Geräteschnittstelle in einem Geräteinformationssatz.

SetupDiXxx-Funktionen , die eine SP_DEVICE_INTERFACE_DETAIL_DATA Struktur als Parameter verwenden, überprüfen, ob der cbSize-Member der angegebenen Struktur gleich der Größe der Struktur in Byte ist. Wenn der cbSize-Member für einen Eingabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt den Fehlercode ERROR_INVALID_PARAMETER fest. Wenn der cbSize-Member für einen Ausgabeparameter nicht ordnungsgemäß festgelegt ist, schlägt die Funktion fehl und legt den Fehlercode ERROR_INVALID_USER_BUFFER fest.

Hinweis

Der Header setupapi.h definiert SP_DEVICE_INTERFACE_DETAIL_DATA 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.

Anforderungen

Anforderung Wert
Header setupapi.h (schließen Sie Setupapi.h ein)

Weitere Informationen

SetupDiGetDeviceInterfaceDetail