Macro WdfObjectDereference
[Aplica-se a KMDF e UMDF]
A macro WdfObjectDereference diminui a contagem de referência para um objeto de estrutura especificado.
Sintaxe
VOID WdfObjectDereference(
[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 a contagem de referência do objeto se tornar zero, o objeto poderá ser excluído antes que WdfObjectDereference retorne.
Um driver só poderá chamar WdfObjectDereference se ele tiver chamado WdfObjectReference anteriormente.
Em vez de chamar WdfObjectDereference, um driver pode chamar WdfObjectDereferenceWithTag ou WdfObjectDereferenceActual.
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 diminui a contagem de referência de um objeto.
WdfObjectDereference(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, wdfioqueuefindrequestfailed, wdfioqueueretriefoundrequest |