Função IoGetRelatedDeviceObject (wdm.h)

  • Artigo

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)

Confira também

IoGetDeviceObjectPointer