Macro WdfObjectReference

  • Artigo

[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

Confira também

WdfObjectReferenceActual

WdfObjectReferenceWithTag