Función IoGetRelatedDeviceObject (wdm.h)

Dado un objeto de archivo, la rutina IoGetRelatedDeviceObject devuelve un puntero al objeto de dispositivo correspondiente.

Sintaxis

PDEVICE_OBJECT IoGetRelatedDeviceObject(
  [in] PFILE_OBJECT FileObject
);

Parámetros

[in] FileObject

Puntero al objeto de archivo.

Valor devuelto

IoGetRelatedDeviceObject devuelve un puntero al objeto de dispositivo.

Comentarios

Cuando se llama a en un objeto de archivo que representa el dispositivo de almacenamiento subyacente, IoGetRelatedDeviceObject devuelve el objeto de dispositivo de nivel superior en la pila de dispositivos de almacenamiento. Para obtener el objeto de dispositivo de nivel superior en la pila de controladores del sistema de archivos, los controladores deben llamar a IoGetRelatedDeviceObject en un objeto de archivo que represente la pila de controladores del sistema de archivos y el sistema de archivos debe montarse actualmente. (De lo contrario, se recorre la pila del dispositivo de almacenamiento en lugar de la pila del sistema de archivos).

Para asegurarse de que el sistema de archivos está montado en el dispositivo de almacenamiento, el controlador debe haber especificado una máscara de acceso adecuada, como FILE_READ_DATA o FILE_WRITE_ATTRIBUTES, al abrir el archivo o dispositivo representado por el objeto de archivo. Especificar FILE_READ_ATTRIBUTES no hace que se monte el sistema de archivos.

El autor de la llamada debe ejecutarse en IRQL <= DISPATCH_LEVEL. Normalmente, los autores de llamadas de esta rutina se ejecutan en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 2000.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (consulte la sección Comentarios)

Consulte también

IoGetDeviceObjectPointer