Macro WdfObjectReference
[Se aplica a KMDF y UMDF]
La macro WdfObjectReference incrementa el recuento de referencias de un objeto de marco especificado.
Sintaxis
VOID WdfObjectReference(
[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 controlador llama a WdfObjectReference para incrementar un recuento de referencias, el controlador debe llamar a WdfObjectDereference para disminuir el recuento.
En lugar de llamar a WdfObjectReference, un controlador puede llamar a WdfObjectReferenceWithTag o WdfObjectReferenceActual.
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 incrementa el recuento de referencias de un objeto.
WdfObjectReference(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 (incluya Wdf.h) |
Biblioteca |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
Reglas de cumplimiento de DDI |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA |