IoGetAttachedDeviceReference-Funktion (wdm.h)
Die IoGetAttachedDeviceReference Routine gibt einen Zeiger auf das Objekt 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 Objekt der höchsten Ebene in einem Stapel angefügter Geräteobjekte zurück, nachdem die Verweisanzahl für das Objekt erhöht wurde.
Bemerkungen
Wenn das Geräteobjekt an DeviceObject keine Geräteobjekte angefügt hat, DeviceObject und der zurückgegebene Zeiger gleich sind.
Gerätetreiber müssen sicherstellen, dass sie nach Abschluss aller Vorgänge, die sie zum Ausführen dieses Aufrufs benötigten, ObDereferenceObject mit dem von dieser Routine zurückgegebenen Geräteobjektzeiger aufrufen. Andernfalls wird verhindert, dass das System das Geräteobjekt aufgrund einer ausstehenden Verweisanzahl freigibt oder löscht.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDIs(storport) |