Funzione IoGetRelatedDeviceObject (wdm.h)

  • Articolo

Dato un oggetto file, la routine IoGetRelatedDeviceObject restituisce un puntatore all'oggetto dispositivo corrispondente.

Sintassi

PDEVICE_OBJECT IoGetRelatedDeviceObject(
  [in] PFILE_OBJECT FileObject
);

Parametri

[in] FileObject

Puntatore all'oggetto file.

Valore restituito

IoGetRelatedDeviceObject restituisce un puntatore all'oggetto dispositivo.

Commenti

Quando viene chiamato su un oggetto file che rappresenta il dispositivo di archiviazione sottostante, IoGetRelatedDeviceObject restituisce l'oggetto dispositivo di livello più alto nello stack di dispositivi di archiviazione. Per ottenere l'oggetto dispositivo di livello più alto nello stack di driver del file system, i driver devono chiamare IoGetRelatedDeviceObject su un oggetto file che rappresenta lo stack di driver del file system e il file system deve essere attualmente montato. In caso contrario, lo stack di dispositivi di archiviazione viene attraversato anziché lo stack del file system.

Per assicurarsi che il file system sia montato nel dispositivo di archiviazione, il driver deve avere specificato una maschera di accesso appropriata, ad esempio FILE_READ_DATA o FILE_WRITE_ATTRIBUTES, all'apertura del file o del dispositivo rappresentato dall'oggetto file. Se si specifica FILE_READ_ATTRIBUTES non viene montato il file system.

Il chiamante deve essere in esecuzione in IRQL <= DISPATCH_LEVEL. In genere, i chiamanti di questa routine vengono eseguiti in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 2000.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (vedere la sezione Osservazioni)

Vedi anche

IoGetDeviceObjectPointer