WdfUsbInterfaceGetDescriptor-Funktion (wdfusb.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfUsbInterfaceGetDescriptor Methode ruft die USB-Schnittstellendeskriptor ab, die einer angegebenen alternativen Einstellung einer angegebenen USB-Schnittstelle zugeordnet ist.

Syntax

void WdfUsbInterfaceGetDescriptor(
  [in]  WDFUSBINTERFACE           UsbInterface,
  [in]  UCHAR                     SettingIndex,
  [out] PUSB_INTERFACE_DESCRIPTOR InterfaceDescriptor
);

Parameter

[in] UsbInterface

Ein Handle für ein USB-Schnittstellenobjekt, das durch Aufrufen WdfUsbTargetDeviceGetInterfaceabgerufen wurde.

[in] SettingIndex

Ein Indexwert, der eine alternative Einstellung für die Schnittstelle identifiziert. Weitere Informationen zu alternativen Einstellungen finden Sie in der USB-Spezifikation.

[out] InterfaceDescriptor

Ein Zeiger auf eine vom Aufrufer zugewiesene USB_INTERFACE_DESCRIPTOR Struktur, die das Framework ausfüllt.

Rückgabewert

Nichts

Bemerkungen

Wenn der wert SettingIndex ungültig ist, kann die USB_INTERFACE_DESCRIPTOR Struktur ungültige Daten empfangen.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Weitere Informationen zu den WdfUsbInterfaceGetDescriptor Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.

Beispiele

Das folgende Codebeispiel ruft den alternativen Einstellungsindex für eine angegebene USB-Schnittstelle ab. Anschließend ruft das Beispiel den USB-Schnittstellendeskriptor ab, der die aktuelle alternative Einstellung der USB-Schnittstelle darstellt.

BYTE  settingIndex;
USB_INTERFACE_DESCRIPTOR  interfaceDescriptor;

settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(
                             UsbInterface
                             );

WdfUsbInterfaceGetDescriptor(
                             UsbInterface,
                             settingIndex,
                             &interfaceDescriptor
                             );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfusb.h (include Wdfusb.h)
Library	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Siehe auch

USB_INTERFACE_DESCRIPTOR

WdfUsbTargetDeviceGetInterface

Freigeben über