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.
Retornar valor
IoGetRelatedDeviceObject retorna um ponteiro para o objeto do dispositivo.
Comentários
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 será 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 em IRQL <= DISPATCH_LEVEL. Normalmente, os chamadores dessa rotina são executados em IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (consulte a seção Comentários) |