EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La de un controlador EvtDeviceSelfManagedIoRestart función de devolución de llamada de eventos reinicia las operaciones de E/S autoadministradas de un dispositivo.
Sintaxis
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
Valor devuelto
Si la función de devolución de llamada EvtDeviceSelfManagedIoRestart no encuentra ningún error, debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(estado) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(estado) es igual a FALSE. Si NT_SUCCESS(estado) es igual a FALSE, el marco detiene el dispositivo y descarga los controladores del dispositivo.
Si NT_SUCCESS(status) es igual a FALSE, el marco llama al EvtDeviceSelfManagedIoFlush y EvtDeviceSelfManagedIoCleanup funciones de devolución de llamada.
Para obtener más información sobre los valores devueltos de esta función de devolución de llamada, consulte Informes de errores de dispositivo.
Observaciones
Para registrar una función de devolución de llamada EvtDeviceSelfManagedIoRestart, un controlador debe llamar a WdfDeviceInitSetPnpPowerEventCallbacks.
Si el controlador ha registrado un EvtDeviceSelfManagedIoRestart función de devolución de llamada, el marco lo llama cada vez que el dispositivo vuelve de un estado de baja potencia a su estado de funcionamiento (D0). El marco llama a la función de devolución de llamada EvtDeviceSelfManagedIoRestart solo después de llamar a la función de devolución de llamada EvtDeviceSelfManagedIoSuspend función de devolución de llamada.
El EvtDeviceSelfManagedIoRestart del controlador función de devolución de llamada debe hacer lo que sea necesario para reanudar las operaciones de E/S autoadministradas del dispositivo.
Para obtener más información sobre cuándo el marco llama a esta función de devolución de llamada, consulte escenarios de PnP y Administración de energía.
Para obtener más información sobre los controladores que proporcionan esta función de devolución de llamada, consulte Using Self-Managed E/S.
Se llama a la función de devolución de llamada EvtDeviceSelfManagedIoRestart en IRQL = PASSIVE_LEVEL. No debe hacer que esta función de devolución de llamada paginable .
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL (consulte la sección Comentarios) |