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

  • Artículo

[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

Consulte también

EvtDeviceEject