EVT_UCX_CONTROLLER_RESET funzione di callback (ucxcontroller.h)
Implementazione del driver client che ucx chiama per reimpostare il controller.
Sintassi
EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;
void EvtUcxControllerReset(
[in] UCXCONTROLLER UcxController
)
{...}
Parametri
[in] UcxController
Handle per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate.
Valore restituito
Nessuno
Osservazioni
Il driver client UCX registra l'implementazione EVT_UCX_CONTROLLER_RESET con l'estensione del controller host USB chiamando il metodo UcxControllerCreate.
Il driver client indica il completamento di questo evento chiamando il metodo UcxControllerResetComplete. In questo modo si garantisce che UCX non chiami EVT_UCX_CONTROLLER_RESET una seconda volta prima del completamento del callback dell'evento.
Se il driver client chiama UcxControllerNeedsReset, UCX chiama questa funzione di callback dell'evento. Tuttavia, UCX può chiamare questa funzione di callback degli eventi anche quando il driver client non ha chiamato UcxControllerNeedsReset.
Esempi
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);
}
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | ucxcontroller.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |