EVT_UCX_CONTROLLER_RESET función de devolución de llamada (ucxcontroller.h)

  • Artículo

Implementación del controlador cliente a la que UCX llama para restablecer el controlador.

Sintaxis

EVT_UCX_CONTROLLER_RESET EvtUcxControllerReset;

void EvtUcxControllerReset(
  [in] UCXCONTROLLER UcxController
)
{...}

Parámetros

[in] UcxController

Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método UcxControllerCreate .

Valor devuelto

None

Observaciones

El controlador cliente UCX registra su implementación de EVT_UCX_CONTROLLER_RESET con la extensión del controlador de host USB (UCX) llamando al método UcxControllerCreate .

El controlador cliente indica la finalización de este evento llamando al método UcxControllerResetComplete . Esto garantiza que UCX no llame a EVT_UCX_CONTROLLER_RESET una segunda vez antes de que se complete la devolución de llamada de este evento.

Si el controlador cliente llama a UcxControllerNeedsReset, UCX llama a esta función de devolución de llamada de evento. Sin embargo, UCX puede llamar a esta función de devolución de llamada de evento incluso cuando el controlador cliente no ha llamado a UcxControllerNeedsReset.

Ejemplos

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);
}

Requisitos

Requisito Value
Plataforma de destino Windows
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado ucxcontroller.h (incluya Ucxclass.h)
IRQL PASSIVE_LEVEL

Consulte también

UcxControllerCreate

UcxControllerNeedsReset

UcxControllerResetComplete