Makro WdfObjectDereference

[Platí pro KMDF a UMDF]

WdfObjectDereference makro sníží počet odkazů pro zadaný objekt architektury.

Syntaxe

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Parametry

popisovač [in]
Popisovač objektu architektury.

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 WdfObjectDereference vrátí.

Ovladač může volat WdfObjectDereference pouze v případě, že dříve volal WdfObjectReference.

Místo volání WdfObjectDereferencemůže ovladač volat WdfObjectDereferenceWithTag nebo WdfObjectDereferenceActual.

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.

WdfObjectDereference(Object); 

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
Pravidla dodržování předpisů DDI	DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

Viz také

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference