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

None

Remarques

Le pilote client UCX inscrit son implémentation EVT_UCX_CONTROLLER_RESET avec l’extension de contrôleur d’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 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é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);
}

Configuration requise

   
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