IoGetRelatedDeviceObject-Funktion (wdm.h)

  • Artikel

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")

Weitere Informationen

IoGetDeviceObjectPointer