IoGetRelatedDeviceObject-Funktion (wdm.h)
Bei einem Dateiobjekt gibt die IoGetRelatedDeviceObject-Routine einen Zeiger auf das entsprechende Geräteobjekt zurück.
Syntax
PDEVICE_OBJECT IoGetRelatedDeviceObject(
[in] PFILE_OBJECT FileObject
);
Parameter
[in] FileObject
Zeiger auf das Dateiobjekt.
Rückgabewert
IoGetRelatedDeviceObject gibt einen Zeiger auf das Geräteobjekt zurück.
Hinweise
Beim Aufruf für ein Dateiobjekt, das das zugrunde liegende Speichergerät darstellt, gibt IoGetRelatedDeviceObject das Geräteobjekt der höchsten Ebene im Speichergerätestapel zurück. Um das Geräteobjekt der obersten Ebene im Dateisystemtreiberstapel abzurufen, müssen Treiber IoGetRelatedDeviceObject für ein Dateiobjekt aufrufen, das den Treiberstapel des Dateisystems darstellt, und das Dateisystem muss derzeit eingebunden werden. (Andernfalls wird der Speichergerätestapel anstelle des Dateisystemstapels durchlaufen.)
Um sicherzustellen, dass das Dateisystem auf dem Speichergerät eingebunden ist, muss der Treiber beim Öffnen der Datei oder des Durch das Dateiobjekt dargestellten Geräts eine geeignete Zugriffsmaske angegeben haben, z. B. FILE_READ_DATA oder FILE_WRITE_ATTRIBUTES. Wenn Sie FILE_READ_ATTRIBUTES angeben, wird das Dateisystem nicht eingebunden.
Der Aufrufer muss unter IRQL <= DISPATCH_LEVEL ausgeführt werden. In der Regel werden Aufrufer dieser Routine unter IRQL = PASSIVE_LEVEL ausgeführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |