Función IoGetRelatedDeviceObject (wdm.h)
Dado un objeto de archivo, el IoGetRelatedDeviceObject rutina 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.
Observaciones
Cuando se llama en un objeto de archivo que representa el dispositivo de almacenamiento subyacente, IoGetRelatedDeviceObject devuelve el objeto de dispositivo de nivel más alto en la pila de dispositivos de almacenamiento. Para obtener el objeto de dispositivo de nivel más alto en la pila de controladores del sistema de archivos, los controladores deben llamar a IoGetRelatedDeviceObject en un objeto de archivo que representa la pila de controladores del sistema de archivos y el sistema de archivos debe montarse actualmente. (De lo contrario, la pila de dispositivos de almacenamiento se recorre 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL (consulte la sección Comentarios) |