Condividi tramite


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 di 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 NTSTATUS codice di errore.

Fabbisogno

Requisito Valore
client minimo supportato Windows 10
server minimo supportato Windows Server 2016
piattaforma di destinazione Finestre
versione minima di KMDF 1.15
intestazione udecxusbdevice.h (include Udecx.h)
libreria Udecxstub.lib
IRQL PASSIVE_LEVEL

Vedere anche

architettura : UDE (USB Device Emulation)

descrittori di stringhe USB

UdecxUsbDeviceInitAllocate

Scrivere un driver client UDE