Partager via


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

Voir aussi

UcxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete