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 |