IoGetRelatedDeviceObject-Funktion (wdm.h)
Bei einem Dateiobjekt gibt das 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.
Bemerkungen
Wenn ein Dateiobjekt aufgerufen wird, das das zugrunde liegende Speichergerät darstellt, gibt IoGetRelatedDeviceObject das Geräteobjekt der höchsten Ebene im Speichergerätestapel zurück. Um das Objekt der höchsten Ebene im Dateisystemtreiberstapel abzurufen, müssen Treiber IoGetRelatedDeviceObject- für ein Dateiobjekt aufrufen, das den Treiberstapel des Dateisystems darstellt, und das Dateisystem muss zurzeit bereitgestellt werden. (Andernfalls wird der Speichergerätestapel anstelle des Dateisystemstapels durchlaufen.)
Um sicherzustellen, dass das Dateisystem auf dem Speichergerät bereitgestellt wird, muss der Treiber beim Öffnen der datei oder des durch das Dateiobjekt dargestellten Geräts eine entsprechende Zugriffsmaske angegeben haben, z. B. FILE_READ_DATA oder FILE_WRITE_ATTRIBUTES. Wenn Sie FILE_READ_ATTRIBUTES angeben, wird das Dateisystem nicht bereitgestellt.
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 |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |