Udostępnij za pośrednictwem


Makro WdfObjectDereference

[Dotyczy usług KMDF i UMDF]

Makro WdfObjectDereference dekrementuje liczbę odwołań dla określonego obiektu struktury.

Składnia

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Parametry

Dojście [in]
Uchwyt do obiektu struktury.

Wartość zwracana

Żaden.

Sprawdzanie usterek występuje, jeśli sterownik dostarcza nieprawidłowy uchwyt obiektu.

Uwagi

Jeśli liczba odwołań obiektu stanie się zero, obiekt może zostać usunięty przed zwróceniem WdfObjectDereference.

Sterownik może wywołać WdfObjectDereference tylko wtedy, gdy wcześniej nosił nazwę WdfObjectReference.

Zamiast wywoływać WdfObjectDereference, sterownik może wywołać WdfObjectDereferenceWithTag lub WdfObjectDereferenceActual.

Aby uzyskać więcej informacji na temat liczby odwołań do obiektów, zobacz Framework Object Life Cycle.

Przykłady

Poniższy przykład kodu dekrementuje liczbę odwołań do obiektu.

WdfObjectDereference(Object); 

Wymagania

Platforma docelowa

universal

Minimalna wersja usługi KMDF

1.0

Minimalna wersja UMDF

2.0

Nagłówek

Wdfobject.h (w tym Wdf.h)

Biblioteka

Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)

IRQL

<= DISPATCH_LEVEL

Reguły zgodności DDI

DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

Zobacz też

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference