Função UdecxUsbDeviceInitAddStringDescriptor (udecxusbdevice.h)

Adiciona um descritor de cadeia de caracteres USB aos parâmetros de inicialização usados para criar um dispositivo USB virtual.

Sintaxe

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

Parâmetros

[in, out] UdecxUsbDeviceInit

Um ponteiro para uma estrutura alocada por WDF que contém parâmetros de inicialização para o dispositivo USB virtual. O driver cliente recuperou esse ponteiro na chamada anterior para UdecxUsbDeviceInitAllocate.

[in] String

Uma cadeia de caracteres Unicode que contém o descritor de cadeia de caracteres USB a ser adicionado ao dispositivo.

[in] DescriptorIndex

O índice do descritor.

[in] LanguageId

O identificador de idioma da cadeia de caracteres. O driver cliente deve definir constantes para o suporte ao idioma, como:

const USHORT US_ENGLISH = 0x409;

Valor de retorno

O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um código de erro NTSTATUS apropriado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
versão mínima do KMDF	1.15
cabeçalho	udecxusbdevice.h (inclua Udecx.h)
biblioteca	Udecxstub.lib
IRQL	PASSIVE_LEVEL