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) |