Función IoGetAttachedDeviceReference (wdm.h)
La rutina IoGetAttachedDeviceReference devuelve un puntero al objeto de dispositivo de nivel más alto de una pila de controladores e incrementa el recuento de referencias en ese objeto.
Sintaxis
PDEVICE_OBJECT IoGetAttachedDeviceReference(
[in] PDEVICE_OBJECT DeviceObject
);
Parámetros
[in] DeviceObject
Puntero al objeto de dispositivo para el que se recupera el objeto de dispositivo conectado más arriba.
Valor devuelto
ioGetAttachedDeviceReference devuelve un puntero al objeto de dispositivo de nivel más alto en una pila de objetos de dispositivo conectados después de incrementar el recuento de referencias en el objeto.
Observaciones
Si el objeto de dispositivo en DeviceObject no tiene ningún objeto de dispositivo asociado, deviceObject y el puntero devuelto son iguales.
Los escritores de controladores de dispositivo deben asegurarse de que, cuando hayan completado todas las operaciones que les obligan a realizar esta llamada, llamen a ObDereferenceObject con el puntero de objeto de dispositivo devuelto por esta rutina. Si no lo hace, se impedirá que el sistema libere o elimine el objeto de dispositivo debido a un recuento de referencias pendiente.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDIs(storport) |