EVT_WDF_DEVICE_SET_LOCK função de retorno de chamada (wdfpdo.h)

  • Artigo

[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

Confira também

EvtDeviceEject