EVT_UCX_CONTROLLER_RESET fonction de rappel (ucxcontroller.h)
Implémentation du pilote client qu’UCX appelle pour réinitialiser le contrôleur.
Syntaxe
EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;
void EvtUcxControllerReset(
[in] UCXCONTROLLER UcxController
)
{...}
Paramètres
[in] UcxController
Handle du contrôleur UCX que le pilote client a reçu lors d’un appel précédent à la méthode UcxControllerCreate .
Valeur de retour
None
Remarques
Le pilote client UCX inscrit son implémentation EVT_UCX_CONTROLLER_RESET avec l’extension du contrôleur hôte USB (UCX) en appelant la méthode UcxControllerCreate .
Le pilote client indique la fin de cet événement en appelant la méthode UcxControllerResetComplete . Cela garantit qu’UCX n’appelle pas EVT_UCX_CONTROLLER_RESET une deuxième fois avant la fin de ce rappel d’événement.
Si le pilote client appelle UcxControllerNeedsReset, UCX appelle cette fonction de rappel d’événement. Toutefois, UCX peut appeler cette fonction de rappel d’événements même si le pilote client n’a pas appelé UcxControllerNeedsReset.
Exemples
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);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | ucxcontroller.h (inclure Ucxclass.h) |
| IRQL | PASSIVE_LEVEL |