共用方式為

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