Funzione IoGetDiskDeviceObject (ntifs.h)

La routine IoGetDiskDeviceObject recupera un puntatore all'oggetto dispositivo disco associato a un determinato oggetto dispositivo del volume del file system.

Sintassi

NTSTATUS IoGetDiskDeviceObject(
  [in] PDEVICE_OBJECT FileSystemDeviceObject,
       PDEVICE_OBJECT *DiskDeviceObject
);

Parametri

[in] FileSystemDeviceObject

Puntatore all'oggetto dispositivo del file system.

DiskDeviceObject

Puntatore a una variabile che riceve l'indirizzo dell'oggetto dispositivo per l'oggetto dispositivo disco.

Valore restituito

IoGetDiskDeviceObject restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Uno dei parametri passati a questa funzione non è valido.
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

Commenti

IoGetDiskDeviceObject restituisce un puntatore all'oggetto dispositivo di archiviazione associato al volume del file system. Il dispositivo di archiviazione non deve essere un disco effettivo

I driver di filtro del file system in genere chiamano IoGetDiskDeviceObject per un oggetto dispositivo del volume del file system per determinare se il volume è montato.

IoGetDiskDeviceObject incrementa il conteggio dei riferimenti sull'oggetto dispositivo disco a cui punta DeviceObject. Ogni chiamata a IoGetDiskDeviceObject deve quindi corrispondere a una chiamata successiva a ObDereferenceObject.

Requisiti

Requisito	Valore
Client minimo supportato	Aggiornamento cumulativo di Windows 2000 SP4; Windows XP
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Vedi anche

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject