EVT_UCX_CONTROLLER_RESET fonction de rappel (ucxcontroller.h)

Implémentation du pilote client que 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 reçu par le pilote client lors d’un appel précédent à la méthode UcxControllerCreate.

Valeur de retour

Aucun

Remarques

Le pilote client UCX inscrit son implémentation EVT_UCX_CONTROLLER_RESET auprès de l’extension de contrôleur hôte USB (UCX) en appelant la méthode UcxControllerCreate.

Le pilote client indique l’achèvement de cet événement en appelant la méthode UcxControllerResetComplete. Cela garantit que UCX n’appelle pas EVT_UCX_CONTROLLER_RESET une seconde 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énement même lorsque 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);
}

Exigences

Voir aussi

ucxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete