Makro WdfObjectDereferenceWithTag

[Platí pro KMDF a UMDF]

WdfObjectDereferenceWithTag makro sníží počet odkazů pro zadaný objekt architektury a přiřadí aktuální název souboru a číslo řádku ovladače odkazu. Toto makro také přiřadí referenční hodnotě značky.

Syntaxe

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

Parametry

popisovač [in]
Popisovač objektu architektury.

značka [in]
Hodnota definovaná ovladačem, která identifikuje odkaz na objekt. Hodnota značky musí odpovídat hodnotě značky, kterou ovladač dříve zadal pro WdfObjectReferenceWithTag.

Návratová hodnota

Žádné.

K chybě dojde, pokud ovladač poskytuje neplatný popisovač objektu.

Poznámky

Pokud se počet odkazů objektu změní na nulu, může být objekt odstraněn před WdfObjectDereferenceWithTag vrátí.

Volání WdfObjectDereferenceActual nebo WdfObjectDereferenceWithTag místo WdfObjectDereference poskytuje další informace (řetězec značky, číslo řádku a název souboru) ladicímu programu Microsoftu. WdfObjectDereferenceActual umožňuje ovladači zadat číslo řádku a název souboru, zatímco WdfObjectDereferenceWithTag používá aktuální číslo řádku a název souboru ovladače.

Hodnoty názvu značky, řádku a názvu souboru můžete zobrazit pomocí !wdftagtracker přípony ladicího programu. Rozšíření ladicího programu zobrazí hodnotu značky jako ukazatel i řadu znaků. Další informace o rozšíření ladicího programu naleznete v tématu Ladění ovladače KMDF.

Další informace o počtech odkazů na objekty naleznete v tématu Framework Object Life Cycle.

Příklady

Následující příklad kódu dekrementuje počet odkazů objektu a přiřadí hodnotu značky odkazu.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Požadavky

Cílová platforma	univerzální
Minimální verze SLUŽBY KMDF	1.0
Minimální verze UMDF	2.0
Záhlaví	Wdfobject.h (včetně Wdf.h)
Knihovna	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL

Viz také

WdfObjectDereference

WdfObjectReferenceWithTag