Funzione IoGetDiskDeviceObject (ntifs.h)
La routine IoGetDiskDeviceObject recupera un puntatore all'oggetto dispositivo disco associato a un determinato oggetto dispositivo 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 |
|---|---|
|
Uno dei parametri passati a questa funzione non è valido. |
|
|
|
Osservazioni
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 chiamano in genere IoGetDiskDeviceObject per un oggetto dispositivo del volume del file system per determinare se il volume è montato.
IoGetDiskDeviceObject incrementa il conteggio dei riferimenti nell'oggetto dispositivo disco a cui punta DeviceObject. Pertanto, ogni chiamata riuscita a IoGetDiskDeviceObject deve essere confrontata con una chiamata successiva a ObDereferenceObject.
Fabbisogno
| 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 |