UdecxUsbDeviceInitSetEndpointsType 函数 (udecxusbdevice.h)

指示客户端驱动程序用于创建虚拟 USB 设备的初始化参数中的终结点类型(简单或动态)。

语法

VOID UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

参数

[in, out] UdecxUsbDeviceInit

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

[in] UdecxEndpointType

指示 USB 终结点类型的 UDECX_ENDPOINT_TYPE类型值。

返回值

没有

言论

在创建虚拟 USB 设备之前,客户端驱动程序必须指示它支持的终结点类型。 它可以支持以下两种类型之一(在 UDECX_ENDPOINT_TYPE中定义):

  • 简单终结点 - 客户端驱动程序在插入设备之前创建所有终结点对象。 设备每个接口必须只有一个配置和一个接口设置。
  • 动态终结点 - 客户端在 EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE 回调函数中创建终结点对象。 USB 设备仿真类扩展 (UdeCx) 在获取添加或配置终结点的请求时调用驱动程序的实现。
UdecxUsbDeviceInit 是一种不透明结构,其中包含指向与终结点相关的回调函数的指针。 如果客户端驱动程序支持动态终结点,则驱动程序必须实现这些回调函数: 在调用此方法之前,客户端驱动程序必须通过调用 UdecxUsbDeviceInitSetStateChangeCallbacks来设置这些指针。

要求

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

另请参阅

体系结构:USB 设备仿真(UDE)

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE

USB 终结点

UdecxUsbDeviceInitAllocate

UdecxUsbDeviceInitSetStateChangeCallbacks

编写 UDE 客户端驱动程序