UdecxUsbDeviceInitAddStringDescriptorRaw-Funktion (udecxusbdevice.h)

Fügt den Initialisierungsparametern zum Erstellen eines virtuellen USB-Geräts einen USB-Zeichenfolgendeskriptor hinzu.

Syntax

NTSTATUS UdecxUsbDeviceInitAddStringDescriptorRaw(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      PUCHAR               Descriptor,
  [in]      USHORT               DescriptorLength,
  [in]      UCHAR                DescriptorIndex,
  [in]      USHORT               LanguageId
);

Parameter

[in, out] UdecxUsbDeviceInit

Ein Zeiger auf eine WDF-zugeordnete Struktur, die Initialisierungsparameter für das virtuelle USB-Gerät enthält. Der Clienttreiber hat diesen Zeiger im vorherigen Aufruf von UdecxUsbDeviceInitAllocate abgerufen.

[in] Descriptor

Ein vom Aufrufer zugewiesener Puffer, der den USB-Deskriptor enthält, der dem Gerät hinzugefügt werden soll.

[in] DescriptorLength

Die Länge des Deskriptorpuffers.

[in] DescriptorIndex

Der Index des Deskriptors.

[in] LanguageId

Der Sprachbezeichner der Zeichenfolge. Der Clienttreiber muss Konstanten für die Sprachunterstützung definieren, z. B.:

const USHORT US_ENGLISH = 0x409;

Rückgabewert

Die Methode gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen entsprechenden NTSTATUS-Fehlercode zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
KMDF-Mindestversion	1.15
Kopfzeile	udecxusbdevice.h (einschließlich Udecx.h)
Bibliothek	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

USB-Zeichenfolgendeskriptoren

UdecxUsbDeviceInitAllocate

Schreiben eines UDE-Clienttreibers