Makro WdfObjectDereferenceWithTag

[Dotyczy usług KMDF i UMDF]

Makro WdfObjectDereferenceWithTag dekrementuje liczbę odwołań dla określonego obiektu struktury i przypisuje bieżącą nazwę pliku i numer wiersza sterownika do odwołania. To makro przypisuje również wartość tagu do odwołania.

Składnia

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

Parametry

Dojście [in]
Uchwyt do obiektu struktury.

Tag [in]
Wartość zdefiniowana przez sterownik identyfikujący odwołanie do obiektu. Wartość tagu musi być zgodna z wartością tagu podaną wcześniej przez sterownik WdfObjectReferenceWithTag.

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 WdfObjectDereferenceWithTag.

Wywoływanie WdfObjectDereferenceActual lub WdfObjectDereferenceWithTag zamiast WdfObjectDereference zawiera dodatkowe informacje (ciąg tagu, numer wiersza i nazwa pliku) do debugerów firmy Microsoft. WdfObjectDereferenceActual umożliwia sterownikowi określenie numeru wiersza i nazwy pliku, podczas gdy WdfObjectDereferenceWithTag używa bieżącego numeru wiersza i nazwy pliku sterownika.

Wartości tagu, numeru wiersza i nazwy pliku można wyświetlić przy użyciu rozszerzenia debugera !wdftagtracker. Rozszerzenie debugera wyświetla wartość tagu zarówno jako wskaźnik, jak i serię znaków. Aby uzyskać więcej informacji na temat rozszerzeń debugera, zobacz Debugowanie sterownika KMDF.

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 dekreuje liczbę odwołań obiektu i przypisuje wartość tagu do odwołania.

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

Wymagania

Zobacz też

WdfObjectDereference

WdfObjectReferenceWithTag