Makro WdfObjectReferenceWithTag

[Dotyczy usług KMDF i UMDF]

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

Składnia

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

Parametry

Dojście [in]
Uchwyt do obiektu struktury.

Tag [in]
Zdefiniowana przez sterownik wartość przechowywana przez strukturę jako tag identyfikacji odwołania do obiektu.

Wartość zwracana

Żaden.

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

Uwagi

Jeśli sterownik wywołuje WdfObjectReferenceWithTag, aby zwiększać liczbę odwołań, sterownik musi wywołać WdfObjectDereferenceWithTag, aby usunąć liczbę.

Wywoływanie WdfObjectReferenceActual lub WdfObjectReferenceWithTag zamiast WdfObjectReference zawiera dodatkowe informacje (wartość tagu, numer wiersza i nazwa pliku) do debugerów firmy Microsoft. WdfObjectReferenceActual umożliwia sterownikowi określenie numeru wiersza i nazwy pliku, podczas gdy WdfObjectReferenceWithTag 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 zwiększa liczbę odwołań obiektu i przypisuje wartość tagu do odwołania.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

Wymagania

Zobacz też

WdfObjectReference