Función IoGetDiskDeviceObject (ntifs.h)
La rutina IoGetDiskDeviceObject recupera un puntero al objeto de dispositivo de disco asociado a un objeto de dispositivo de volumen del sistema de archivos determinado.
Sintaxis
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
Parámetros
[in] FileSystemDeviceObject
Puntero al objeto de dispositivo del sistema de archivos.
DiskDeviceObject
Puntero a una variable que recibe la dirección del objeto de dispositivo para el objeto de dispositivo de disco.
Valor devuelto
IoGetDiskDeviceObject devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
Uno de los parámetros pasados a esta función no era válido. |
|
|
|
Comentarios
IoGetDiskDeviceObject devuelve un puntero al objeto de dispositivo de almacenamiento asociado al volumen del sistema de archivos. El dispositivo de almacenamiento no necesita ser un disco real.
Normalmente, los controladores de filtro del sistema de archivos llaman a IoGetDiskDeviceObject para un objeto de dispositivo de volumen del sistema de archivos para determinar si el volumen está montado.
IoGetDiskDeviceObject incrementa el recuento de referencias en el objeto de dispositivo de disco al que apunta DeviceObject. Por lo tanto, cada llamada correcta a IoGetDiskDeviceObject debe coincidir con una llamada posterior a ObDereferenceObject.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Paquete acumulativo de actualizaciones de Windows 2000 SP4; Windows XP |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |