EVT_WDF_DEVICE_SET_LOCK función de devolución de llamada (wdfpdo.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventos EvtDeviceSetLock de un controlador bloquea el dispositivo especificado para que no se pueda expulsar o desbloquea el dispositivo para que se pueda expulsar.
Sintaxis
EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;
NTSTATUS EvtWdfDeviceSetLock(
[in] WDFDEVICE Device,
[in] BOOLEAN IsLocked
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] IsLocked
Valor booleano que indica si el controlador debe bloquear o desbloquear el dispositivo. Si es TRUE, el controlador debe bloquear el dispositivo para que no se pueda expulsar. Si es FALSE, el controlador debe desbloquear el dispositivo para que se pueda expulsar.
Valor devuelto
Si el controlador bloquea o desbloquea correctamente el dispositivo, debe devolver STATUS_SUCCESS. De lo contrario, debe devolver un valor NTSTATUS que NT_SUCCESS se evalúa como FALSE.
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
Los controladores de bus basados en marco pueden proporcionar una función de devolución de llamada EvtDeviceSetLock . Para registrar esta función de devolución de llamada, los controladores de bus llaman a WdfPdoInitSetEventCallbacks.
El marco llama a la función de devolución de llamada EvtDeviceSetLock del controlador cuando el administrador de PnP solicita al controlador de autobús que bloquee o desbloquee uno de sus dispositivos secundarios enumerados.
No implementar una función de devolución de llamada EvtDeviceSetLock para un dispositivo equivale a devolver un valor NTSTATUS que se evalúa como FALSE.
Para obtener más información sobre los valores devueltos, vea Compatibilidad con dispositivos ejectables.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfpdo.h (incluya Wdf.h) |
| IRQL | PASSIVE_LEVEL |