Макрос WdfObjectDereference

  • Статья

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

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

Синтаксис

VOID WdfObjectDereference(
  [in] WDFOBJECT Handle
);

Параметры

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

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

Нет.

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

Комментарии

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

Драйвер может вызывать WdfObjectDereference , только если он ранее вызывал WdfObjectReference.

Вместо вызова WdfObjectDereference драйвер может вызывать WdfObjectDereferenceWithTag или WdfObjectDereferenceActual.

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

Примеры

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

WdfObjectDereference(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, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest

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

WdfObjectDereferenceActual

WdfObjectDereferenceWithTag

WdfObjectReference