IoGetAttachedDeviceReference-Funktion (ntifs.h)

Die IoGetAttachedDeviceReference-Routine gibt einen Zeiger auf das Geräteobjekt der höchsten Ebene in einem Treiberstapel zurück und erhöht die Verweisanzahl 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öchsten angefügte Geräteobjekt abgerufen wird.

Rückgabewert

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

Hinweise

Wenn für das Geräteobjekt unter DeviceObject keine Geräteobjekte angefügt sind, sind DeviceObject und der zurückgegebene Zeiger gleich.

Gerätetreiber-Autoren müssen sicherstellen, dass sie obDereferenceObject mit dem von dieser Routine zurückgegebenen Geräteobjektzeiger aufrufen, wenn sie alle Vorgänge abgeschlossen haben, für die sie diesen Aufruf erforderten. Andernfalls wird verhindert, dass das System das Geräteobjekt aufgrund einer ausstehenden Referenzanzahl freigibt oder löscht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000
Zielplattform	Universell
Header	ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDIs(storport)

Weitere Informationen

ObDereferenceObject