Função IoGetRelatedDeviceObject (wdm.h)
Dado um objeto de arquivo, a rotina IoGetRelatedDeviceObject retorna um ponteiro para o objeto de dispositivo correspondente.
Sintaxe
PDEVICE_OBJECT IoGetRelatedDeviceObject(
[in] PFILE_OBJECT FileObject
);
Parâmetros
[in] FileObject
Ponteiro para o objeto de arquivo.
Valor de retorno
IoGetRelatedDeviceObject retorna um ponteiro para o objeto do dispositivo.
Observações
Quando chamado em um objeto de arquivo que representa o dispositivo de armazenamento subjacente, IoGetRelatedDeviceObject retorna o objeto de dispositivo de nível mais alto na pilha do dispositivo de armazenamento. Para obter o objeto de dispositivo de nível mais alto na pilha de driver do sistema de arquivos, os drivers devem chamar IoGetRelatedDeviceObject em um objeto de arquivo que representa a pilha de driver do sistema de arquivos e o sistema de arquivos deve ser montado no momento. (Caso contrário, a pilha do dispositivo de armazenamento é percorrida em vez da pilha do sistema de arquivos.)
Para garantir que o sistema de arquivos esteja montado no dispositivo de armazenamento, o driver deve ter especificado uma máscara de acesso apropriada, como FILE_READ_DATA ou FILE_WRITE_ATTRIBUTES, ao abrir o arquivo ou dispositivo representado pelo objeto de arquivo. Especificar FILE_READ_ATTRIBUTES não faz com que o sistema de arquivos seja montado.
O chamador deve estar em execução no IRQL <= DISPATCH_LEVEL. Normalmente, os chamadores dessa rotina estão em execução no IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (consulte a seção Comentários) |