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 (UCX) 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 che il callback dell'evento venga completato.
Se il driver client chiama UcxControllerNeedsReset, UCX chiama questa funzione di callback degli eventi. Tuttavia, UCX può chiamare questa funzione di callback degli eventi anche quando il driver client non ha chiamato UcxControllerNeedsReset.
Esempio
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);
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | ucxcontroller.h (include Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |