UdecxUsbDeviceInitAddStringDescriptor-Funktion (udecxusbdevice.h)
Fügt einen USB-Zeichenfolgendeskriptor zu den Initialisierungsparametern hinzu, die zum Erstellen eines virtuellen USB-Geräts verwendet werden.
Syntax
NTSTATUS UdecxUsbDeviceInitAddStringDescriptor(
[in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
[in] PCUNICODE_STRING String,
[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 UdecxUsbDeviceInitAllocateabgerufen.
[in] String
Eine Unicode-Zeichenfolge, die den USB-Zeichenfolgendeskriptor enthält, der dem Gerät hinzugefügt werden soll.
[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 geeigneten NTSTATUS Fehlercode zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.15 |
| Header- | udecxusbdevice.h (include Udecx.h) |
| Library | Udecxstub.lib |
| IRQL- | PASSIVE_LEVEL |