EVT_UCX_CONTROLLER_RESET funzione di callback (ucxcontroller.h)

  • Articolo

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 per il 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 . In questo modo si garantisce che UCX non chiami EVT_UCX_CONTROLLER_RESET una seconda volta prima che il callback dell'evento venga completato.

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

Requisito Valore
Piattaforma di destinazione Windows
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione ucxcontroller.h (include Ucxclass.h)
IRQL PASSIVE_LEVEL

Vedi anche

UcxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete