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