Macro WdfObjectReference
[Aplica-se a KMDF e UMDF]
A macro WdfObjectReference incrementa a contagem de referência para um objeto de estrutura especificado.
Sintaxe
VOID WdfObjectReference(
[in] WDFOBJECT Handle
);
Parâmetros
Manipular [in]
Um identificador para um objeto de estrutura.
Valor retornado
Nenhum.
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
Se o driver chamar WdfObjectReference para incrementar uma contagem de referência, o driver deverá chamar WdfObjectDereference para diminuir a contagem.
Em vez de chamar WdfObjectReference, um driver pode chamar WdfObjectReferenceWithTag ou WdfObjectReferenceActual.
Para obter mais informações sobre contagens de referência de objeto, consulte Ciclo de Vida do Objeto Framework.
Exemplos
O exemplo de código a seguir incrementa a contagem de referência de um objeto.
WdfObjectReference(Object);
Requisitos
Plataforma de destino |
Universal |
Versão mínima do KMDF |
1.0 |
Versão mínima do UMDF |
2,0 |
parâmetro |
Wdfobject.h (inclua Wdf.h) |
Biblioteca |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |
Regras de conformidade de DDI |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA |