Makro WdfObjectReferenceWithTag

[Platí pro KMDF a UMDF]

WdfObjectReferenceWithTag makro zvýší počet odkazů pro zadaný objekt architektury a přiřadí aktuální název souboru a číslo řádku ovladače odkazu. Makro také přiřadí k odkazu hodnotu značky.

Syntaxe

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

Parametry

popisovač [in]
Popisovač objektu architektury.

značka [in]
Hodnota definovaná ovladačem, kterou architektura ukládá jako identifikační značku pro odkaz na objekt.

Návratová hodnota

Žádné.

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

Poznámky

Pokud ovladač volá WdfObjectReferenceWithTag zvýšit počet odkazů, ovladač musí volat WdfObjectDereferenceWithTag dekrementace počtu.

Volání WdfObjectReferenceActual nebo WdfObjectReferenceWithTag místo WdfObjectReference poskytuje další informace (hodnota značky, číslo řádku a název souboru) ladicímu programu Microsoftu. WdfObjectReferenceActual umožňuje ovladači zadat číslo řádku a název souboru, zatímco WdfObjectReferenceWithTag 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 zvýší počet odkazů objektu a přiřadí hodnotu značky k odkazu.

WdfObjectReferenceWithTag(
                          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é

WdfObjectReference