EVT_WDF_DEVICE_SET_LOCK função de retorno de chamada (wdfpdo.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada de evento EvtDeviceSetLock de um driver bloqueia o dispositivo especificado para que ele não possa ser ejetado ou desbloqueie o dispositivo para que ele possa ser ejetado.
Sintaxe
EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;
NTSTATUS EvtWdfDeviceSetLock(
[in] WDFDEVICE Device,
[in] BOOLEAN IsLocked
)
{...}
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] IsLocked
Um valor booliano que indica se o driver deve bloquear ou desbloquear o dispositivo. Se TRUE, o driver deverá bloquear o dispositivo para que ele não possa ser ejetado. Se FALSE, o driver deverá desbloquear o dispositivo para que ele possa ser ejetado.
Retornar valor
Se o driver bloquear ou desbloquear o dispositivo com êxito, ele deverá retornar STATUS_SUCCESS. Caso contrário, ele deverá retornar um valor NTSTATUS que NT_SUCCESS é avaliado como FALSE.
Para obter mais informações sobre os valores retornados dessa função de retorno de chamada, consulte Relatando falhas de dispositivo.
Comentários
Os drivers de barramento baseados em estrutura podem fornecer uma função de retorno de chamada EvtDeviceSetLock . Para registrar essa função de retorno de chamada, os drivers de barramento chamam WdfPdoInitSetEventCallbacks.
A estrutura chama a função de retorno de chamada EvtDeviceSetLock do driver quando o gerenciador PnP solicita que o driver de barramento bloqueie ou desbloqueie um de seus dispositivos filho enumerados.
Não implementar uma função de retorno de chamada EvtDeviceSetLock para um dispositivo é equivalente a retornar um valor NTSTATUS que é avaliado como FALSE.
Para obter mais informações sobre valores retornados, consulte Suporte a dispositivos ejetáveis.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfpdo.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |