Compartilhar via


Função IoGetDeviceToVerify (ntifs.h)

A rotina IoGetDeviceToVerify retorna um ponteiro para o objeto do dispositivo, representando um dispositivo de mídia removível, que é o destino da solicitação de E/S do thread fornecido.

Sintaxe

PDEVICE_OBJECT IoGetDeviceToVerify(
  [in] PETHREAD Thread
);

Parâmetros

[in] Thread

Ponteiro para uma estrutura ETHREAD cujo objeto de dispositivo está sendo consultado. Ou seja, Thread é o thread para o qual um driver de nível mais alto está tentando verificar a validade da mídia na qual o thread abriu um arquivo.

Retornar valor

IoGetDeviceToVerify retorna um ponteiro para uma estrutura DEVICE_OBJECT que identifica o objeto do dispositivo que representa um dispositivo no qual a mídia deve ser verificada. Essa função pode retornar NULL.

Comentários

Em geral, os drivers de nível mais alto, particularmente os sistemas de arquivos, são mais propensos a chamar essa rotina.

Um driver de dispositivo de mídia removível subjacente é responsável por notificar drivers de nível superior, especialmente o sistema de arquivos, quando a mídia parece ter sido alterada desde o último acesso ao dispositivo de destino. Para obter mais informações, consulte Notificando o sistema de arquivos de possíveis alterações de mídia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

Confira também

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread