Макрос WdfObjectReferenceWithTag
[Относится к KMDF и UMDF]
Макрос WdfObjectReferenceWithTag увеличивает количество ссылок для указанного объекта платформы и присваивает ссылке текущее имя файла драйвера и номер строки. Макрос также присваивает ссылке значение тега.
Синтаксис
VOID WdfObjectReferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
Параметры
Дескриптор [в]
Дескриптор объекта платформы.
Тег [in]
Определенное драйвером значение, которое платформа сохраняет в качестве идентификационного тега для ссылки на объект.
Возвращаемое значение
Нет.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Если драйвер вызывает WdfObjectReferenceWithTag для увеличения количества ссылок, драйвер должен вызвать WdfObjectDereferenceWithTag , чтобы уменьшать счетчик.
Вызов WdfObjectReferenceActual или WdfObjectReferenceWithTag вместо WdfObjectReference предоставляет дополнительные сведения (значение тега, номер строки и имя файла) отладчикам Майкрософт. WdfObjectReferenceActual позволяет драйверу указать номер строки и имя файла, а WdfObjectReferenceWithTag использует текущий номер строки и имя файла драйвера.
Вы можете просмотреть значения тега, номера строки и имени файла с помощью расширения отладчика !wdftagtracker . Расширение отладчика отображает значение тега в виде указателя и ряда символов. Дополнительные сведения о расширениях отладчика см. в разделе Отладка драйвера KMDF.
Дополнительные сведения о количестве ссылок на объекты см. в разделе Жизненный цикл объектов платформы.
Примеры
В следующем примере кода увеличивается количество ссылок объекта и присваивается значение тега ссылке.
WdfObjectReferenceWithTag(
object,
pTag
);
Требования
Целевая платформа |
Универсальное |
Минимальная версия KMDF |
1,0 |
Минимальная версия UMDF |
2,0 |
Заголовок |
Wdfobject.h (включая Wdf.h) |
Библиотека |
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL |
<= DISPATCH_LEVEL |