wdfusb.h 标头
wdf 使用此标头。 有关详细信息，请参阅：
wdfusb.h 包含以下编程接口：
函数
| WDF_USB_CONTINUOUS_READER_CONFIG_INIT WDF_USB_CONTINUOUS_READER_CONFIG_INIT 函数初始化WDF_USB_CONTINUOUS_READER_CONFIG 结构。 |
| WDF_USB_CONTROL_SETUP_PACKET_INIT WDF_USB_CONTROL_SETUP_PACKET_INIT 函数初始化标准 USB 控制传输的WDF_USB_CONTROL_SETUP_PACKET结构。 |
| WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS WDF_USB_CONTROL_SETUP_PACKET_INIT_CLASS 函数为设备类特定的 USB 控制传输初始化WDF_USB_CONTROL_SETUP_PACKET结构。 |
| WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE WDF_USB_CONTROL_SETUP_PACKET_INIT_FEATURE 函数为设置或清除设备功能的 USB 控制传输初始化WDF_USB_CONTROL_SETUP_PACKET结构。 |
| WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS WDF_USB_CONTROL_SETUP_PACKET_INIT_GET_STATUS 函数为获取设备状态的 USB 控制传输初始化WDF_USB_CONTROL_SETUP_PACKET结构。 |
| WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR WDF_USB_CONTROL_SETUP_PACKET_INIT_VENDOR 函数为供应商特定的 USB 控制传输初始化WDF_USB_CONTROL_SETUP_PACKET结构。 |
| WDF_USB_DEVICE_CREATE_CONFIG_INIT WDF_USB_DEVICE_CREATE_CONFIG_INIT 函数初始化WDF_USB_DEVICE_CREATE_CONFIG 结构。 |
| WDF_USB_DEVICE_INFORMATION_INIT WDF_USB_DEVICE_INFORMATION_INIT 函数初始化驱动程序的WDF_USB_DEVICE_INFORMATION结构。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_DECONFIG 函数初始化 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 结构，以便驱动程序可以取消配置 USB 设备。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_INTERFACES_DESCRIPTORS 函数初始化 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 结构，以便驱动程序可以使用 USB 描述符指定配置。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_MULTIPLE_INTERFACES 函数初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS结构，以便驱动程序可以将设备配置为使用多个接口。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_SINGLE_INTERFACE 函数初始化WDF_USB_DEVICE_SELECT_CONFIG_PARAMS结构，以便驱动程序可以将设备配置为使用单个指定接口。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB WDF_USB_DEVICE_SELECT_CONFIG_PARAMS_INIT_URB 函数初始化 WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 结构，以便驱动程序可以使用 URB 指定配置。 |
| WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_DESCRIPTOR 函数初始化 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构，以便驱动程序可以通过指定接口描述符来选择 USB 接口。 |
| WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_SETTING 函数初始化 WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构，以便驱动程序可以通过指定接口对象的句柄和接口的备用设置来选择 USB 接口。 |
| WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB WDF_USB_INTERFACE_SELECT_SETTING_PARAMS_INIT_URB 函数初始化WDF_USB_INTERFACE_SELECT_SETTING_PARAMS结构，以便驱动程序可以通过指定 URB 来选择 USB 接口。 |
| WDF_USB_PIPE_DIRECTION_IN WDF_USB_PIPE_DIRECTION_IN 函数确定指定的 USB 终结点是否为输入终结点。 |
| WDF_USB_PIPE_DIRECTION_OUT WDF_USB_PIPE_DIRECTION_OUT 函数确定指定的 USB 终结点是否为输出终结点。 |
| WDF_USB_PIPE_INFORMATION_INIT WDF_USB_PIPE_INFORMATION_INIT函数初始化WDF_USB_PIPE_INFORMATION结构。 |
| WdfUsbInterfaceGetConfiguredPipe WdfUsbInterfaceGetConfiguredPipe 方法返回与指定的 USB 设备接口和管道索引关联的框架管道对象的句柄。 （可选）该方法还会返回有关管道的信息。 |
| WdfUsbInterfaceGetConfiguredSettingIndex WdfUsbInterfaceGetConfiguredSettingIndex 方法返回当前为指定的 USB 设备接口选择的备用设置索引。 |
| WdfUsbInterfaceGetDescriptor WdfUsbInterfaceGetDescriptor 方法检索与指定 USB 接口的指定备用设置关联的 USB 接口描述符。 |
| WdfUsbInterfaceGetEndpointInformation WdfUsbInterfaceGetEndpointInformation 方法检索有关指定 USB 设备终结点及其关联管道的信息。 |
| WdfUsbInterfaceGetInterfaceNumber WdfUsbInterfaceGetInterfaceNumber 方法返回指定 USB 接口对象的接口号。 |
| WdfUsbInterfaceGetNumConfiguredPipes WdfUsbInterfaceGetNumConfiguredPipes 方法返回为指定的 USB 设备接口配置的管道数。 |
| WdfUsbInterfaceGetNumEndpoints WdfUsbInterfaceGetNumEndpoints 方法返回与指定 USB 接口的指定备用设置关联的终结点数。 |
| WdfUsbInterfaceGetNumSettings WdfUsbInterfaceGetNumSettings 方法返回指定 USB 接口支持的备用设置数。 |
| WdfUsbInterfaceSelectSetting WdfUsbInterfaceSelectSetting 方法为指定的 USB 接口选择指定的备用设置。 |
| WdfUsbTargetDeviceAllocAndQueryString WdfUsbTargetDeviceAllocAndQueryString 方法分配缓冲区，然后检索与指定的 USB 设备和描述符索引值关联的 Unicode 字符串。 |
| WdfUsbTargetDeviceCreate WdfUsbTargetDeviceCreate 方法为指定的框架设备对象创建框架 USB 设备对象，并打开 USB 设备进行 I/O 操作。 |
| WdfUsbTargetDeviceCreateIsochUrb WdfUsbTargetDeviceCreateIsochUrb 方法 (URB) 分配常时等量 USB 请求块。 |
| WdfUsbTargetDeviceCreateUrb WdfUsbTargetDeviceCreateUrb 方法 (URB) 分配 USB 请求块。 |
| WdfUsbTargetDeviceCreateWithParameters WdfUsbTargetDeviceCreateWithParameters 方法为指定的框架设备对象创建框架 USB 设备对象，并打开 USB 设备进行 I/O 操作。 |
| WdfUsbTargetDeviceCyclePortSynchronously WdfUsbTargetDeviceCyclePortSynchronously 方法对指定设备所连接的 USB 端口进行电源循环。 |
| WdfUsbTargetDeviceFormatRequestForControlTransfer WdfUsbTargetDeviceFormatRequestForControlTransfer 方法生成 USB 控制传输请求，但它不会发送请求。 |
| WdfUsbTargetDeviceFormatRequestForCyclePort WdfUsbTargetDeviceFormatRequestForCyclePort 方法为指定设备连接到的端口生成电源周期请求，但它不会发送请求。 |
| WdfUsbTargetDeviceFormatRequestForString WdfUsbTargetDeviceFormatRequestForString 方法生成与 USB 设备的字符串索引值关联的 USB 字符串描述符的请求。 |
| WdfUsbTargetDeviceFormatRequestForUrb WdfUsbTargetDeviceFormatRequestForUrb 方法使用 URB 描述的请求参数为指定的 USB 设备生成 USB 请求，但它不会发送请求。 |
| WdfUsbTargetDeviceGetDeviceDescriptor WdfUsbTargetDeviceGetDeviceDescriptor 方法检索与指定框架 USB 设备对象关联的 USB 设备的 USB 设备描述符。 |
| WdfUsbTargetDeviceGetInterface WdfUsbTargetDeviceGetInterface 方法返回与指定接口索引关联的框架 USB 接口对象的句柄。 |
| WdfUsbTargetDeviceGetIoTarget WdfUsbTargetDeviceGetIoTarget 方法返回与指定 USB 设备关联的 I/O 目标对象的句柄。 |
| WdfUsbTargetDeviceGetNumInterfaces WdfUsbTargetDeviceGetNumInterfaces 方法返回指定 USB 设备支持的 USB 设备接口数。 |
| WdfUsbTargetDeviceIsConnectedSynchronous WdfUsbTargetDeviceIsConnectedSynchronous 方法确定指定的 USB 设备是否已连接。 |
| WdfUsbTargetDeviceQueryString WdfUsbTargetDeviceQueryString 方法检索与指定的 USB 设备和描述符索引值关联的 Unicode 字符串。 |
| WdfUsbTargetDeviceQueryUsbCapability WdfUsbTargetDeviceQueryUsbCapability 方法确定主机控制器和 USB 驱动程序堆栈是否支持特定功能。 |
| WdfUsbTargetDeviceResetPortSynchronously WdfUsbTargetDeviceResetPortSynchronously 方法重置与指定 USB 设备关联的 USB 端口。 |
| WdfUsbTargetDeviceRetrieveConfigDescriptor WdfUsbTargetDeviceRetrieveConfigDescriptor 方法检索与指定框架 USB 设备对象关联的 USB 设备的 USB 配置描述符。 |
| WdfUsbTargetDeviceRetrieveCurrentFrameNumber WdfUsbTargetDeviceRetrieveCurrentFrameNumber 方法检索当前的 USB 帧编号。 |
| WdfUsbTargetDeviceRetrieveInformation WdfUsbTargetDeviceRetrieveInformation 方法检索与指定框架 USB 设备对象关联的 USB 设备的相关信息。 |
| WdfUsbTargetDeviceSelectConfig WdfUsbTargetDeviceSelectConfig 方法为设备选择 USB 配置，或取消配置设备。 |
| WdfUsbTargetDeviceSendControlTransferSynchronously WdfUsbTargetDeviceSendControlTransferSynchronously 方法生成 USB 控制传输请求并将其同步发送到 I/O 目标。 |
| WdfUsbTargetDeviceSendUrbSynchronously WdfUsbTargetDeviceSendUrbSynchronously 方法使用 URB 描述的请求参数将 USB 请求同步发送到指定的 USB 设备。 |
| WdfUsbTargetDeviceWdmGetConfigurationHandle WdfUsbTargetDeviceWdmGetConfigurationHandle 方法返回与指定 USB 设备的当前配置关联的USBD_CONFIGURATION_HANDLE类型句柄。 |
| WdfUsbTargetPipeAbortSynchronously WdfUsbTargetPipeAbortSynchronously 方法生成中止请求并将其同步发送到指定的 USB 管道。 |
| WdfUsbTargetPipeConfigContinuousReader WdfUsbTargetPipeConfigContinuousReader 方法将框架配置为从指定的 USB 管道连续读取。 |
| WdfUsbTargetPipeFormatRequestForAbort WdfUsbTargetPipeFormatRequestForAbort 方法为指定的 USB 管道生成中止请求，但不发送请求。 |
| WdfUsbTargetPipeFormatRequestForRead WdfUsbTargetPipeFormatRequestForRead 方法生成 USB 输入管道的读取请求，但不发送请求。 |
| WdfUsbTargetPipeFormatRequestForReset WdfUsbTargetPipeFormatRequestForReset 方法为指定的 USB 管道生成重置请求，但它不会发送请求。 |
| WdfUsbTargetPipeFormatRequestForUrb WdfUsbTargetPipeFormatRequestForUrb 方法使用指定的 URB 描述的请求参数为指定的 USB 管道生成 USB 请求，但它不会发送请求。 |
| WdfUsbTargetPipeFormatRequestForWrite WdfUsbTargetPipeFormatRequestForWrite 方法生成 USB 输出管道的写入请求，但它不会发送请求。 |
| WdfUsbTargetPipeGetInformation WdfUsbTargetPipeGetInformation 方法检索有关 USB 管道及其终结点的信息。 |
| WdfUsbTargetPipeGetIoTarget WdfUsbTargetPipeGetIoTarget 方法返回与指定 USB 管道关联的 I/O 目标对象的句柄。 |
| WdfUsbTargetPipeGetType WdfUsbTargetPipeGetType 方法返回指定 USB 管道的类型。 |
| WdfUsbTargetPipeIsInEndpoint WdfUsbTargetPipeIsInEndpoint 方法确定指定的 USB 管道是否连接到输入终结点。 |
| WdfUsbTargetPipeIsOutEndpoint WdfUsbTargetPipeIsOutEndpoint 方法确定指定的 USB 管道是否连接到输出终结点。 |
| WdfUsbTargetPipeReadSynchronously WdfUsbTargetPipeReadSynchronously 方法生成读取请求并将其同步发送到指定的 USB 输入管道。 |
| WdfUsbTargetPipeResetSynchronously WdfUsbTargetPipeResetSynchronously 方法生成重置请求并将其同步发送到指定的 USB 管道。 |
| WdfUsbTargetPipeSendUrbSynchronously WdfUsbTargetPipeSendUrbSynchronously 方法使用指定的 URB 描述的请求参数为指定的 USB 管道生成 USB 请求。 |
| WdfUsbTargetPipeSetNoMaximumPacketSizeCheck WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法禁用框架测试驱动程序的读取缓冲区大小是否是 USB 管道最大数据包大小的倍数。 |
| WdfUsbTargetPipeWdmGetPipeHandle WdfUsbTargetPipeWdmGetPipeHandle 方法返回与指定的框架管道对象关联的USBD_PIPE_HANDLE类型句柄。 |
| WdfUsbTargetPipeWriteSynchronously WdfUsbTargetPipeWriteSynchronously 方法生成写入请求并将其同步发送到指定的 USB 输出管道。 |
回调函数
| EVT_WDF_USB_READER_COMPLETION_ROUTINE 驱动程序的 EvtUsbTargetPipeReadComplete 事件回调函数通知驱动程序连续读取器已成功完成读取请求。 |
| EVT_WDF_USB_READERS_FAILED 驱动程序的 EvtUsbTargetPipeReadersFailed 事件回调函数通知驱动程序连续读取器在处理读取请求时报告了错误。 |
结构
| WDF_USB_CONTINUOUS_READER_CONFIG WDF_USB_CONTINUOUS_READER_CONFIG 结构包含框架用于为 USB 管道配置连续读取器的信息。 |
| WDF_USB_CONTROL_SETUP_PACKET WDF_USB_CONTROL_SETUP_PACKET结构描述 USB 控制传输的设置数据包。 |
| WDF_USB_DEVICE_CREATE_CONFIG WDF_USB_DEVICE_CREATE_CONFIG 结构包含框架用于配置框架 USB 设备对象的信息。 |
| WDF_USB_DEVICE_INFORMATION WDF_USB_DEVICE_INFORMATION 结构包含 USB 设备的版本和功能信息。 |
| WDF_USB_DEVICE_SELECT_CONFIG_PARAMS WDF_USB_DEVICE_SELECT_CONFIG_PARAMS 结构指定 USB 设备配置参数。 |
| WDF_USB_INTERFACE_SELECT_SETTING_PARAMS WDF_USB_INTERFACE_SELECT_SETTING_PARAMS 结构包含 USB 接口的选择信息。 |
| WDF_USB_INTERFACE_SETTING_PAIR WDF_USB_INTERFACE_SETTING_PAIR 结构指定指定 USB 接口的备用设置。 |
| WDF_USB_PIPE_INFORMATION WDF_USB_PIPE_INFORMATION 结构包含有关 USB 管道及其终结点的信息。 |
| WDF_USB_REQUEST_COMPLETION_PARAMS WDF_USB_REQUEST_COMPLETION_PARAMS 结构包含与 USB 设备的 I/O 请求完成相关的参数。 |
枚举
| WDF_USB_BMREQUEST_DIRECTION WDF_USB_BMREQUEST_DIRECTION枚举标识 USB 控件传输的数据传输方向。 |
| WDF_USB_BMREQUEST_RECIPIENT WDF_USB_BMREQUEST_RECIPIENT枚举标识 USB 控制传输的数据传输接收方。 |
| WDF_USB_BMREQUEST_TYPE WDF_USB_BMREQUEST_TYPE 枚举标识 USB 控制传输的数据传输类型。 |
| WDF_USB_DEVICE_TRAITS WDF_USB_DEVICE_TRAITS 枚举标识 USB 设备特征。 |
| WDF_USB_PIPE_TYPE WDF_USB_PIPE_TYPE 枚举标识 USB 管道的类型。 |
| WDF_USB_REQUEST_TYPE WDF_USB_REQUEST_TYPE枚举标识基于框架的驱动程序可以发送到 USB I/O 目标的 USB 请求的类型。 |
| WdfUsbTargetDeviceSelectConfigType WdfUsbTargetDeviceSelectConfigType 枚举定义 USB 设备的配置操作类型。 |
| WdfUsbTargetDeviceSelectSettingType WdfUsbTargetDeviceSelectSettingType 枚举定义用于为 USB 接口指定备用设置的技术。 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈