EVT_UCX_CONTROLLER_RESET fungsi panggilan balik (ucxcontroller.h)

Artikel
02/26/2024

Implementasi driver klien yang dipanggil UCX untuk mengatur ulang pengontrol.

Sintaks

EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;

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

Parameter

[in] UcxController

Handel ke pengontrol UCX yang diterima driver klien dalam panggilan sebelumnya ke metode UcxControllerCreate .

Nilai kembali

Tidak ada

Keterangan

Driver klien UCX mendaftarkan implementasi EVT_UCX_CONTROLLER_RESET dengan ekstensi pengontrol host USB (UCX) dengan memanggil metode UcxControllerCreate .

Driver klien menunjukkan penyelesaian peristiwa ini dengan memanggil metode UcxControllerResetComplete . Melakukannya memastikan bahwa UCX tidak memanggil EVT_UCX_CONTROLLER_RESET untuk kedua kalinya sebelum panggilan balik peristiwa ini selesai.

Jika driver klien memanggil UcxControllerNeedsReset, UCX memanggil fungsi panggilan balik peristiwa ini. Namun, UCX dapat memanggil fungsi panggilan balik peristiwa ini bahkan ketika driver klien belum memanggil UcxControllerNeedsReset.

Contoh

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);
}