Макрос WdfDeviceResumeIdleWithTag (wdfdevice.h)
[Применимо к KMDF и UMDF]
Макрос WdfDeviceResumeIdleWithTag уменьшает число ссылок на питание для указанного объекта устройства платформы и назначает текущему имени файла и номеру строки драйвера ссылке. Макрос также назначает значение тега ссылке.
Синтаксис
void WdfDeviceResumeIdleWithTag(
[in] Device,
[in] Tag
);
Параметры
[in] Device
Дескриптор объекта устройства платформы.
[in] Tag
Определяемое драйвером значение, которое платформа сохраняет в качестве тега идентификации для ссылки на питание.
Возвращаемое значение
Никакой
Замечания
Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Если число ссылок объекта становится нулевым, объект может быть удален до возврата WdfDeviceResumeIdleWithTag.
Вызов WdfDeviceResumeIdleWithTag вместо WdfDeviceResumeIdle предоставляет дополнительные сведения (значение тега, номер строки и имя файла), которые можно просмотреть в отладчиках Майкрософт. WdfDeviceResumeIdleWithTag использует текущий номер строки и имя файла драйвера.
Значения тегов, номеров строк и имени файла можно просмотреть с помощью расширения отладчика !wdfkd.wdftagtracker.
Используйте !wdfkd.wdfdevice с подробными флагами и найдите ссылку на !wdftagtracker в выходных данных:
kd> !wdfdevice <handle> f
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| минимальная версия KMDF | 1.15 |
| минимальная версия UMDF | 2.15 |
| заголовка | wdfdevice.h (include Wdf.h) |
| библиотеки | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | DriverCreate, KmdfIrql, KmdfIrql2 |