EVT_UCX_CONTROLLER_RESET fungsi panggilan balik (ucxcontroller.h)
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);
}
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Versi KMDF minimum | 1,0 |
Versi UMDF minimum | 2.0 |
Header | ucxcontroller.h (termasuk Ucxclass.h) |
IRQL | PASSIVE_LEVEL |