EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART función de devolución de llamada (wdfdevice.h)

[Se aplica a KMDF y UMDF]

La función de devolución de llamada de evento EvtDeviceSelfManagedIoRestart de un controlador 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(status) sea igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE. Si NT_SUCCESS(status) 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 a las funciones de devolución de llamada EvtDeviceSelfManagedIoFlush y EvtDeviceSelfManagedIoCleanup del controlador.

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.

Comentarios

Para registrar una función de devolución de llamada EvtDeviceSelfManagedIoRestart , un controlador debe llamar a WdfDeviceInitSetPnpPowerEventCallbacks.

Si el controlador ha registrado una función de devolución de llamada EvtDeviceSelfManagedIoRestart , 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 del controlador.

La función de devolución de llamada EvtDeviceSelfManagedIoRestart del controlador 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 administración de energía y PnP.

Para obtener más información sobre los controladores que proporcionan esta función de devolución de llamada, consulte Uso de Self-Managed E/S.

La función de devolución de llamada EvtDeviceSelfManagedIoRestart se llama en IRQL = PASSIVE_LEVEL. No debe hacer que esta función de devolución de llamada se pueda paginar.

Requisitos

Consulte también

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoInit

EvtDeviceSelfManagedIoSuspend