WdfObjectDereferenceWithTag-makro

[Gäller för KMDF och UMDF]

WdfObjectDereferenceWithTag makrot minskar referensantalet för ett angivet ramverksobjekt och tilldelar drivrutinens aktuella filnamn och radnummer till referensen. Det här makrot tilldelar också ett taggvärde till referensen.

Syntax

VOID WdfObjectDereferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

Parameterar

Hantera [in]
Ett handtag till ett ramverksobjekt.

Tag [in]
Ett drivrutinsdefinierat värde som identifierar en objektreferens. Taggvärdet måste matcha ett taggvärde som drivrutinen tidigare angav till WdfObjectReferenceWithTag.

Returvärde

Ingen.

En felkontroll inträffar om drivrutinen tillhandahåller ett ogiltigt objekthandtag.

Anmärkningar

Om objektets referensantal blir noll kan objektet tas bort innan WdfObjectDereferenceWithTag returnerar.

Anropa WdfObjectDereferenceActual eller WdfObjectDereferenceWithTag i stället för WdfObjectDereference ger ytterligare information (taggsträng, radnummer och filnamn) till Microsoft-felsökningsprogram. WdfObjectDereferenceActual låter drivrutinen ange radnummer och filnamn, medan WdfObjectDereferenceWithTag använder drivrutinens aktuella radnummer och filnamn.

Du kan visa värdena för tagg, radnummer och filnamn med hjälp av !wdftagtracker felsökningstillägg. Felsökningstillägget visar taggvärdet som både en pekare och en serie tecken. Mer information om tillägg för felsökning finns i Felsöka en KMDF-drivrutin.

Mer information om antalet objektreferenser finns i Framework Object Life Cycle.

Exempel

Följande kodexempel minskar referensantalet för ett objekt och tilldelar referensen ett taggvärde.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Krav

Målplattform	Universell
Lägsta KMDF-version	1.0
Lägsta UMDF-version	2.0
Header	Wdfobject.h (inkludera Wdf.h)
Bibliotek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_NIVÅ

Se även

WdfObjectDereference

WdfObjectReferenceWithTag