Макрос 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 |