Función IoGetAttachedDevice (ntifs.h)
La rutina IoGetAttachedDevice devuelve un puntero al objeto de dispositivo de nivel superior asociado al dispositivo especificado.
Sintaxis
PDEVICE_OBJECT IoGetAttachedDevice(
[in] PDEVICE_OBJECT DeviceObject
);
Parámetros
[in] DeviceObject
Puntero al objeto de dispositivo para el que se va a devolver el dispositivo conectado más arriba.
Valor devuelto
IoGetAttachedDevice devuelve el dispositivo de nivel más alto conectado al dispositivo especificado.
Comentarios
Si el objeto de dispositivo especificado por DeviceObject no tiene ningún otro objeto de dispositivo asociado, DeviceObject y el puntero devuelto son iguales.
IoGetAttachedDevice difiere de IoGetAttachedDeviceReference en los siguientes aspectos:
IoGetAttachedDevice no incrementa el recuento de referencias en el objeto de dispositivo. (Por lo tanto, no se requiere ninguna llamada coincidente a ObDereferenceObject ).
Los autores de llamadas de IoGetAttachedDevice deben asegurarse de que no se agreguen o quiten objetos de dispositivo de la pila mientras se ejecuta IoGetAttachedDevice . Los autores de llamadas que no pueden hacerlo deben usar IoGetAttachedDeviceReference en su lugar.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |