UdecxUsbDeviceInitAddStringDescriptor 函数 (udecxusbdevice.h)

将 USB 字符串描述符添加到用于创建虚拟 USB 设备的初始化参数。

语法

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

参数

[in, out] UdecxUsbDeviceInit

指向 WDF 分配结构的指针,该结构包含虚拟 USB 设备的初始化参数。 客户端驱动程序在上一次调用 UdecxUsbDeviceInitAllocate 时检索了此指针。

[in] String

一个 Unicode 字符串,其中包含要添加到设备的 USB 字符串描述符。

[in] DescriptorIndex

描述符的索引。

[in] LanguageId

字符串的语言标识符。 客户端驱动程序必须为语言支持定义常量,例如:

const USHORT US_ENGLISH = 0x409;

返回值

如果操作成功,该方法将返回STATUS_SUCCESS。 否则,此方法可能会返回相应的 NTSTATUS 错误代码。

要求

要求
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
最低 KMDF 版本 1.15
标头 udecxusbdevice.h (包括 Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

体系结构:USB 设备模拟 (UDE)

USB 字符串描述符

UdecxUsbDeviceInitAllocate

编写 UDE 客户端驱动程序