Макрос WdfObjectReference

  • Статья

[Относится к KMDF и UMDF]

Макрос WdfObjectReference увеличивает количество ссылок для указанного объекта платформы.

Синтаксис

VOID WdfObjectReference(
  [in] WDFOBJECT Handle
);

Параметры

Дескриптор [в]
Дескриптор объекта платформы.

Возвращаемое значение

Нет.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Если драйвер вызывает WdfObjectReference для увеличения количества ссылок, драйвер должен вызвать WdfObjectDereference для уменьшения счетчика.

Вместо вызова WdfObjectReference драйвер может вызывать WdfObjectReferenceWithTag или WdfObjectReferenceActual.

Дополнительные сведения о количестве ссылок на объекты см. в разделе Жизненный цикл объектов платформы.

Примеры

В следующем примере кода увеличивается количество ссылок объекта.

WdfObjectReference(Object);

Требования

Целевая платформа

 Универсальное

Минимальная версия KMDF

1,0

Минимальная версия UMDF

2,0

Заголовок

 Wdfobject.h (включая Wdf.h)

Библиотека

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

IRQL

<= DISPATCH_LEVEL

Правила соответствия DDI

 DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA

См. также раздел

WdfObjectReferenceActual

WdfObjectReferenceWithTag