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 al 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 . Ciò garantisce che UCX non chiami EVT_UCX_CONTROLLER_RESET una seconda volta prima che questo callback evento venga completato.

Se il driver client chiama UcxControllerNeedsReset, UCX chiama questa funzione di callback evento. Tuttavia, UCX può chiamare questa funzione di callback evento 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

   
Piattaforma di destinazione Windows
Versione KMDF minima 1,0
Versione UMDF minima 2,0
Intestazione ucxcontroller.h (includere Ucxclass.h)
IRQL PASSIVE_LEVEL

Vedi anche

UcxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete