IoGetAttachedDevice-Funktion (ntifs.h)
Die IoGetAttachedDevice Routine gibt einen Zeiger auf das Geräteobjekt der höchsten Ebene zurück, das dem angegebenen Gerät zugeordnet ist.
Syntax
PDEVICE_OBJECT IoGetAttachedDevice(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Ein Zeiger auf das Geräteobjekt, für das das oberste angeschlossene Gerät zurückgegeben werden soll.
Rückgabewert
IoGetAttachedDevice gibt das gerät der höchsten Ebene zurück, das an das angegebene Gerät angeschlossen ist.
Bemerkungen
Wenn das durch DeviceObject angegebene Geräteobjekt keine anderen Geräteobjekte angefügt hat, DeviceObject- und der zurückgegebene Zeiger gleich sind.
IoGetAttachedDevice unterscheidet sich von IoGetAttachedDeviceReference- in folgender Hinsicht:
IoGetAttachedDevice erhöht die Verweisanzahl für das Geräteobjekt nicht. (Daher ist kein übereinstimmender Aufruf an ObDereferenceObject erforderlich.)
Aufrufer von IoGetAttachedDevice- müssen sicherstellen, dass keine Geräteobjekte dem Stapel hinzugefügt oder entfernt werden, während IoGetAttachedDevice ausgeführt wird. Aufrufer, die dies nicht tun können, müssen stattdessen IoGetAttachedDeviceReference- verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |