EVT_UCX_CONTROLLER_RESET función de devolución de llamada (ucxcontroller.h)
Implementación del controlador cliente 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
Ninguno
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. Al hacerlo, se garantiza que UCX no llame a EVT_UCX_CONTROLLER_RESET 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 | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | ucxcontroller.h (incluya Ucxclass.h) |
| irQL | PASSIVE_LEVEL |