Función IoGetDiskDeviceObject (ntifs.h)

El IoGetDiskDeviceObject rutina 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
STATUS_INVALID_PARAMETER	Uno de los parámetros pasados a esta función no era válido.
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

Observaciones

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 del objeto de dispositivo de disco al que apunta DeviceObject. Por lo tanto, todas las llamadas correctas a IoGetDiskDeviceObject deben coincidir con una llamada posterior a ObDereferenceObject.

Requisitos

Requisito	Valor
cliente mínimo admitido	Paquete acumulativo de actualizaciones de Windows 2000 SP4; Windows XP
de la plataforma de destino de	Universal
encabezado de	ntifs.h (incluya Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= DISPATCH_LEVEL

Consulte también

ioEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

obDereferenceObject