IoGetLowerDeviceObject-Funktion (ntifs.h)

  • Artikel

Die IoGetLowerDeviceObject-Routine gibt einen Zeiger auf das nächstniedrige Geräteobjekt auf dem Treiberstapel zurück.

Syntax

PDEVICE_OBJECT IoGetLowerDeviceObject(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Ein Zeiger auf das Geräteobjekt im Stapel, für das das Geräteobjekt der nächstniedrigen Ebene zurückgegeben werden soll.

Rückgabewert

IoGetLowerDeviceObject gibt einen Zeiger auf das nächstniedrige Geräteobjekt auf dem Treiberstapel zurück.

Hinweise

Bei einem Zeiger auf ein Geräteobjekt in einem Dateisystem oder Gerätetreiberstapel gibt IoGetLowerDeviceObject einen Zeiger auf das nächstniedrige Geräteobjekt auf dem Stapel zurück.

IoGetLowerDeviceObject gibt NULL zurück, wenn:

  • Der Treiber der nächstniedrigen Ebene wird nicht geladen.

  • Der Treiber der nächstniedrigen Ebene wird derzeit entladen, entfernt oder gelöscht.

  • Das Geräteobjekt, auf das von DeviceObject verwiesen wird, ist das niedrigste Geräteobjekt im Treiberstapel.

Ein Dateisystemfiltertreiber verwendet in der Regel IoGetLowerDeviceObject , um zu bestimmen, ob er bereits an den Filtertreiberstapel angefügt ist, der über einem bestimmten Dateisystemgeräteobjekt verkettet ist. Zunächst ruft der Filter IoGetAttachedDeviceReference auf, um einen Zeiger auf das oberste Geräteobjekt im Stapel abzurufen. Anschließend wird IoGetLowerDeviceObject wiederholt aufgerufen, um den Treiberstapel zu durchlaufen, wobei jedes Geräteobjekt überprüft wird, ob das Objekt zum Filtertreiber gehört.

IoGetLowerDeviceObject erhöht die Verweisanzahl für das nächstniedrige Geräteobjekt, falls vorhanden. Daher muss jeder Aufruf von IoGetLowerDeviceObject , der null nicht zurückgibt, durch einen nachfolgenden Aufruf obDereferenceObject abgeglichen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 SP4-Updaterollup; Windows XP
Zielplattform Universell
Header ntifs.h (include Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Weitere Informationen

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject