EVT_UCX_CONTROLLER_RESET función de devolución de llamada (ucxcontroller.h)
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 |