EVT_UCX_USBDEVICE_ENABLE回调函数 (ucxusbdevice.h)

UCX 调用客户端驱动程序的实现,以将有关设备及其默认控制终结点的程序信息引入控制器。

语法

EVT_UCX_USBDEVICE_ENABLE EvtUcxUsbdeviceEnable;

void EvtUcxUsbdeviceEnable(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

参数

[in] UcxController

客户端驱动程序在对 UcxControllerCreate 方法的上一次调用中收到的 UCX 控制器的句柄。

[in] Request

类型为 USBDEVICE_ENABLE的结构。

返回值

没有

言论

UCX 客户端驱动程序通过调用 UcxUsbDeviceCreate 方法,将此回调函数注册到 USB 主机控制器扩展 (UCX)。

若要将设备转换为所需状态,主机控制器驱动程序将与硬件通信以完成请求。

在此回调函数中,客户端驱动程序准备控制器以接受和计划 USB 设备的默认控制终结点上的传输。

驱动程序完成后,它将完成 WDFREQUEST。

客户端驱动程序在 请求中返回完成状态。 驱动程序可以异步完成 WDFREQUEST。

例子

VOID
UsbDevice_EvtUcxUsbDeviceEnable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)
    
{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEnable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceEnable = (PUSBDEVICE_ENABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

要求

要求 价值
目标平台 窗户
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxusbdevice.h (include Ucxclass.h)
IRQL DISPATCH_LEVEL

另请参阅

UcxUsbDeviceCreate