EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La función de devolución de llamada de eventos EvtDeviceSelfManagedIoInit de un controlador inicializa e inicia las operaciones de E/S autoadministradas del dispositivo.
Sintaxis
EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;
NTSTATUS EvtWdfDeviceSelfManagedIoInit(
[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 EvtDeviceSelfManagedIoInit no encuentra ningún error, debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es 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 no inicia el 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 EvtDeviceSelfManagedIoInit , un controlador debe llamar a WdfDeviceInitSetPnpPowerEventCallbacks.
Si el controlador ha registrado una función de devolución de llamada EvtDeviceSelfManagedIoInit , el marco lo llama una vez para cada dispositivo, una vez que el marco ha llamado a la función de devolución de llamada EvtDeviceD0Entry del controlador por primera vez. El marco no llama a la función de devolución de llamada EvtDeviceSelfManagedIoInit de nuevo para ese dispositivo, a menos que se quite y vuelva a conectar el dispositivo, o se vuelvan a cargar los controladores.
La función de devolución de llamada EvtDeviceSelfManagedIoInit debe inicializar e iniciar las operaciones de E/S autoadministradas que controlará el controlador para el 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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |
| IRQL | PASSIVE_LEVEL |