Macro WdfObjectDereference
[Se aplica a KMDF y UMDF]
La macro WdfObjectDereference disminuye el recuento de referencias de un objeto de marco especificado.
Sintaxis
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
Parámetros
Identificador [in]
Identificador de un objeto de marco.
Valor devuelto
Ninguno.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
Si el recuento de referencias del objeto se convierte en cero, es posible que el objeto se elimine antes de que WdfObjectDereference devuelva.
Un controlador puede llamar a WdfObjectDereference solo si anteriormente se ha llamado a WdfObjectReference.
En lugar de llamar a WdfObjectDereference, un controlador puede llamar a WdfObjectDereferenceWithTag o WdfObjectDereferenceActual.
Para obtener más información sobre los recuentos de referencia de objetos, vea Ciclo de vida de objetos de marco.
Ejemplos
En el ejemplo de código siguiente se disminuye el recuento de referencias de un objeto.
WdfObjectDereference(Object);
Requisitos
Plataforma de destino |
Universal |
Versión mínima de KMDF |
1.0 |
Versión mínima de UMDF |
2.0 |
Encabezado |
Wdfobject.h (incluir Wdf.h) |
Biblioteca |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
Reglas de cumplimiento de DDI |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |