Função IoSetDeviceToVerify (ntifs.h)

A rotina IoSetDeviceToVerify define o objeto do dispositivo a ser verificado no thread especificado. O objeto de dispositivo especificado representa um dispositivo de mídia removível.

Sintaxe

void IoSetDeviceToVerify(
  [in]           PETHREAD       Thread,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

Parâmetros

[in] Thread

Ponteiro para uma estrutura de objeto de thread ETHREAD para o thread.

[in, optional] DeviceObject

Ponteiro para uma estrutura de DEVICE_OBJECT que identifica o objeto de dispositivo para um dispositivo de mídia removível. DeviceObject pode ser NULL.

Retornar valor

Nenhum

Comentários

Antes de usar IoSetDeviceToVerify e IoVerifyVolume, os autores de driver devem estudar a maneira como essas rotinas são usadas na amostra FASTFAT. Para obter informações adicionais, consulte também Suporte a mídia removível.

IoSetDeviceToVerify é chamado para indicar que um determinado objeto de dispositivo, representando um dispositivo de mídia removível, precisa ser verificado. Chame IoGetDeviceToVerify para obter o objeto de dispositivo que é o destino da solicitação de E/S do thread fornecido.

Um driver do sistema de arquivos deve verificar um volume quando recebe uma notificação de um driver de dispositivo de mídia removível subjacente de que a mídia parece ter sido alterada desde o último acesso ao dispositivo de destino. O sistema de arquivos normalmente chama IoSetDeviceToVerify e IoVerifyVolume quando o dispositivo inferior retorna STATUS_VERIFY_REQUIRED.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI IrqlIoDispatch(wdm)

Confira também

IRP

IoGetDeviceToVerify

IoVerifyVolume

PsGetCurrentThread