Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
[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 de retorno
Nenhum.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
Se a contagem de referência do objeto se tornar zero, o objeto poderá ser excluído antes que WdfObjectDereference retorne.
Um driver pode chamar WdfObjectDereference somente se tiver chamado anteriormente WdfObjectReference.
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 Framework Object Life Cycle.
Exemplos
O exemplo de código a seguir diminui a contagem de referência de um objeto.
WdfObjectDereference(Object);
Requerimentos
Plataforma de destino |
Universal |
Versão mínima do KMDF |
1.0 |
Versão mínima UMDF |
2.0 |
Cabeçalho |
Wdfobject.h (inclui Wdf.h) |
Biblioteca |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= NÍVEL_DE_DESPACHO |
Regras de conformidade com DDI |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |