共用方式為

EVT_UCX_CONTROLLER_RESET回呼函式 （ucxcontroller.h）

  • 發行項

UCX 呼叫以重設控制器的用戶端驅動程序實作。

語法

EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;

void EvtUcxControllerReset(
  [in] UCXCONTROLLER UcxController
)
{...}

參數

[in] UcxController

用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的 UCX 控制器句柄。

傳回值

沒有

言論

UCX 用戶端驅動程式會呼叫 UcxControllerCreate 方法，向 USB 主機控制器擴充功能 （UCX） 註冊其 EVT_UCX_CONTROLLER_RESET 實作。

用戶端驅動程式會呼叫 UcxControllerResetComplete 方法來指出此事件完成。 這樣做可確保UCX不會在第二次呼叫 EVT_UCX_CONTROLLER_RESET 此事件回呼完成。

如果客戶端驅動程式呼叫 UcxControllerNeedsReset，UCX 會呼叫此事件回呼函式。 不過，即使用戶端驅動程式尚未呼叫 UcxControllerNeedsReset，UCX 仍可能會呼叫這個事件回呼函式。

例子

VOID
Controller_EvtControllerReset(
    UCXCONTROLLER UcxController
)

{
    UCX_CONTROLLER_RESET_COMPLETE_INFO controllerResetCompleteInfo;

    //
    // TODO: Reset the controller
    //

    //
    // TODO: Were devices and endpoints programmed in the controller before the reset
    // still programmed in the controller after the reset?
    //
    UCX_CONTROLLER_RESET_COMPLETE_INFO_INIT(&controllerResetCompleteInfo,
                                            UcxControllerStateLost,
                                            TRUE); // reset due to UCX, received EvtReset after WDF power-up

    DbgTrace(TL_INFO, Controller, "Controller_EvtControllerReset");

    UcxControllerResetComplete(UcxController, &controllerResetCompleteInfo);
}

要求

要求 價值
目標平臺 窗戶
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 ucxcontroller.h （include Ucxclass.h）
IRQL PASSIVE_LEVEL

另請參閱

UcxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete