Udostępnij przez


Makro WdfObjectReference

[Dotyczy usług KMDF i UMDF]

Makro WdfObjectReference zwiększa liczbę odwołań dla określonego obiektu struktury.

Składnia

VOID WdfObjectReference(
  [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 sterownik wywołuje WdfObjectReference, aby zwiększać liczbę odwołań, sterownik musi wywołać WdfObjectDereference, aby usunąć liczbę.

Zamiast wywoływać WdfObjectReference, sterownik może wywołać WdfObjectReferenceWithTag lub WdfObjectReferenceActual.

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 zwiększa liczbę odwołań do obiektu.

WdfObjectReference(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

Zobacz też

WdfObjectReferenceActual

WdfObjectReferenceWithTag