EVT_UCX_USBDEVICE_DISABLE回调函数 (ucxusbdevice.h)

  • 项目

UCX 调用的客户端驱动程序实现，用于释放与设备及其默认终结点关联的控制器资源。

语法

EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;

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

参数

[in] UcxController

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

[in] Request

USBDEVICE_DISABLE 类型的结构。

返回值

无

备注

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

当客户端驱动程序释放控制器资源时，它将完成 WDFREQUEST。 完成后，UCX 调用的引用此 USB 设备的唯一回调函数是 EVT_UCX_USBDEVICE_ENABLE。

当设备处于禁用状态时，UCX 不会为其计划传输。

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

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

示例

VOID
UsbDevice_EvtUcxUsbDeviceDisable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)


{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

要求

要求 值
目标平台 Windows
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxusbdevice.h (包括 Ucxclass.h)
IRQL DISPATCH_LEVEL

另请参阅

UcxUsbDeviceCreate