EVT_WDF_DEVICE_SET_LOCK función de devolución de llamada (wdfpdo.h)

[Solo se aplica a KMDF]

El controlador EvtDeviceSetLock función de devolución de llamada de eventos bloquea el dispositivo especificado para que no se pueda expulsar o desbloquear 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 TRUE, el controlador debe bloquear el dispositivo para que no se pueda expulsar. Si 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.

Observaciones

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 del controlador EvtDeviceSetLock cuando el administrador de PnP solicita al controlador de bus que bloquee o desbloquee uno de sus dispositivos secundarios enumerados.

No implementar un EvtDeviceSetLock función de devolución de llamada 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 expulsables.

Requisitos

Consulte también

EvtDeviceEject