Compartilhar via


Função UdecxUsbDeviceInitAddStringDescriptorRaw (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 UdecxUsbDeviceInitAddStringDescriptorRaw(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      PUCHAR               Descriptor,
  [in]      USHORT               DescriptorLength,
  [in]      UCHAR                DescriptorIndex,
  [in]      USHORT               LanguageId
);

Parâmetros

[in, out] UdecxUsbDeviceInit

Um ponteiro para uma estrutura alocada pelo 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] Descriptor

Um buffer alocado pelo chamador que contém o descritor USB a ser adicionado ao dispositivo.

[in] DescriptorLength

O comprimento do buffer do descritor.

[in] DescriptorIndex

O índice do descritor.

[in] LanguageId

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

const USHORT US_ENGLISH = 0x409;

Retornar valor

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
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
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

Confira também

Arquitetura: UDE (Emulação de Dispositivo USB)

Descritores de cadeia de caracteres USB

UdecxUsbDeviceInitAllocate

Escrever um driver de cliente UDE