Función IoGetAttachedDevice (ntifs.h)

  • Artículo

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

Consulte también

IoGetAttachedDeviceReference

ObDereferenceObject