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) |