Macro WdfObjectDereference

[Aplica-se ao KMDF e UMDF]

A macro WdfObjectDereference decrementa 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.

Ocorre uma verificação de bug se o driver fornece 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 pode chamar WdfObjectDereference somente se 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

Cabeçalho

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, wdfioqueueretrievefoundrequest

Confira também

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference