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 estruturaETHREADcujo 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.

Valor de retorno

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.

Observações

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, particularmente 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
de cliente com suporte mínimo Windows 2000
da Plataforma de Destino Universal
cabeçalho ntifs.h (inclua Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs(storport), IrqlIoDispatch(wdm), PowerIrpDDis(wdm)

Consulte também

IoIsErrorUserInduced

IoSetDeviceToVerify

IoSetHardErrorOrVerifyDevice

PsGetCurrentThread