IoGetAttachedDeviceReference-Funktion (wdm.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 oberste 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 dem Geräteobjekt bei DeviceObject keine Geräteobjekte angefügt sind, sind DeviceObject und der zurückgegebene Zeiger gleich.

Gerätetreiberautoren müssen sicherstellen, dass ob ObDereferenceObject mit dem von dieser Routine zurückgegebenen Geräteobjektzeiger aufgerufen wird, wenn sie alle Vorgänge abgeschlossen haben, die diesen Aufruf erfordern. Andernfalls wird verhindert, dass das System das Geräteobjekt aufgrund einer ausstehenden Verweisanzahl freigibt oder löscht.

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
DDI-Complianceregeln	DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDIs(storport)

Weitere Informationen

ObDereferenceObject