Funzione UdecxUsbDeviceInitAddStringDescriptor (udecxusbdevice.h)

Aggiunge un descrittore di stringa USB ai parametri di inizializzazione usati per creare un dispositivo USB virtuale.

Sintassi

NTSTATUS UdecxUsbDeviceInitAddStringDescriptor(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      PCUNICODE_STRING     String,
  [in]      UCHAR                DescriptorIndex,
  [in]      USHORT               LanguageId
);

Parametri

[in, out] UdecxUsbDeviceInit

Puntatore a una struttura allocata da WDF che contiene parametri di inizializzazione per il dispositivo USB virtuale. Il driver client ha recuperato questo puntatore nella chiamata precedente a UdecxUsbDeviceInitAllocate.

[in] String

Stringa Unicode che contiene il descrittore di stringa USB da aggiungere al dispositivo.

[in] DescriptorIndex

Indice del descrittore.

[in] LanguageId

Identificatore della lingua della stringa. Il driver client deve definire costanti per il supporto linguistico, ad esempio:

const USHORT US_ENGLISH = 0x409;

Valore restituito

Il metodo restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire un codice di errore NTSTATUS appropriato.

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Versione KMDF minima 1.15
Intestazione udecxusbdevice.h (include Udecx.h)
Libreria Udecxstub.lib
IRQL PASSIVE_LEVEL

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

Descrittori di stringhe USB

UdecxUsbDeviceInitAllocate

Scrivere un driver client UDE