IoGetAttachedDeviceReference-Funktion (ntifs.h)

Die IoGetAttachedDeviceReference-Routine gibt einen Zeiger auf das Objekt der höchsten Ebene in einem Treiberstapel zurück und erhöht die Referenzanzahl für dieses Objekt.

Syntax

PDEVICE_OBJECT IoGetAttachedDeviceReference(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Zeiger auf das Geräteobjekt, für das das am häufigsten angefügte Geräteobjekt abgerufen wird.

Rückgabewert

IoGetAttachedDeviceReference gibt einen Zeiger auf das Objekt der höchsten Ebene in einem Stapel angefügter Geräteobjekte zurück, nachdem die Referenzanzahl für das Objekt erhöht wurde.

Bemerkungen

Wenn das Geräteobjekt bei DeviceObject keine Geräteobjekte enthält, sind DeviceObject und der zurückgegebene Zeiger gleich.

Gerätetreiberautoren müssen sicherstellen, dass, wenn sie alle Vorgänge abgeschlossen haben, die sie zum Ausführen dieses Aufrufs benötigt haben, obDereferenceObject mit dem von dieser Routine zurückgegebenen Geräteobjektzeiger aufruft. Dies verhindert, dass das System das Geräteobjekt aufgrund einer ausstehenden Referenzanzahl freigibt oder löscht.

Anforderungen

   
Unterstützte Mindestversion (Client) Ab Windows 2000 verfügbar.
Zielplattform Universell
Header ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDIs(storport)

Weitere Informationen

ObDereferenceObject